Skip to main content

Endpoint

Authentication

This endpoint requires authentication via API key. Include your API key in the X-API-Key header:

Path Parameters

Request Body

The request body must be a JSON object with the following fields:

Required Fields

File Object Fields

Request Example

Response

Success Response

Status Code: 200 OK

Response Fields

Error Responses

401 Unauthorized

Returned when authentication fails. See the authentication errors section for details.

404 Not Found

Returned when the task doesn’t exist or you don’t have access to it.

409 Conflict

Returned when the task is not at a signature step or the document cannot be attached in the current state.

422 Validation Error

Returned when the request body is invalid.

500 Internal Server Error

Returned when the upload fails due to a server error.

Notes

Use this endpoint when a document is signed outside Chamelio (for example, a manually signed PDF) and you need to attach the executed copy to the signature step.
Call Get Signature Details to obtain the step_run_id for the signature step before uploading.

Use Cases

This endpoint is useful for:
  • Manual signing flows - Attach wet-signed or externally signed documents to a task
  • Third-party signature providers - Record the executed document from a provider not integrated with Chamelio
  • Audit completeness - Ensure the final signed copy is stored against the workflow step