POST /v1/signature/envelopes/{id}/send
const url = 'https://api.asap.cool/v1/signature/envelopes/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/send';const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.asap.cool/v1/signature/envelopes/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/send \ --header 'Authorization: Bearer <token>'Authorizations
Section intitulée « Authorizations »Parameters
Section intitulée « Parameters »Path Parameters
Section intitulée « Path Parameters »Envelope identifier.
Responses
Section intitulée « Responses »Tokens issued, request emails enqueued, envelope sent.
Body of a successful send: the updated envelope plus a sent flag.
object
The envelope after the sent transition (with signers).
object
Targeted assurance level.
The audit chain (present on get, omitted elsewhere).
Public projection of an [AuditEvent]. Hashes are lowercase hex so a
client can re-verify the chain.
object
SHA-256 of the canonical content (hex).
Structured payload.
Event kind.
Stable identifier.
When the event occurred (RFC3339).
Previous link’s content hash (hex), None at genesis.
0-based position in the chain.
Signer the event concerns, if any.
Addresses copied on the completion notification (Cc; may be empty).
When every signer signed (RFC3339).
Consent-text version presented to signers.
Creation timestamp (RFC3339).
SHA-256 of the frozen document (hex), set at send time.
When the envelope (and its tokens) expire (RFC3339).
Whether a proof bundle is available for download.
Whether a signed composited document (source + stamped signatures) is available for download (positioned-field envelopes only).
Stable identifier.
Free-form labels for organizing / filtering (may be empty).
Optional request-email message.
How many automatic reminders have fired so far.
Delay between two automatic reminders, in hours (null = default cadence).
How many automatic reminders may fire over the envelope’s lifetime.
Optional Reply-To for the signature-request email.
Routing mode.
Optional From display name for the signature-request email.
Signers on the envelope (present on get/create, omitted on list).
Public projection of a [Signer]. Never carries access_token_hash or
otp_hash (secrets stay server-side).
object
When the signer gave consent (RFC3339).
Creation timestamp (RFC3339).
Signer email.
Optional full name.
Stable identifier.
Number of failed OTP attempts on the current challenge.
Phone (E.164) for SMS OTP, if set.
Position in a sequential order (0-based).
When the signer signed (RFC3339).
Source IP captured at signing.
Per-signer status.
When the access token expires (RFC3339), if issued.
Last-update timestamp (RFC3339).
Identity-verification method.
Logical reference to the signed document.
What the envelope wraps.
Lifecycle status.
Optional request-email subject.
Last-update timestamp (RFC3339).
Number of access links dispatched (one per signer).
Always true on a 200 response.
Example generated
{ "envelope": { "assurance_level": "example", "audit_chain": [ { "content_hash": "example", "event_data": "example", "event_type": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "occurred_at": "example", "prev_hash": "example", "seq_index": 1, "signer_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" } ], "cc_recipients": [ "example" ], "completed_at": "example", "consent_text_version": "example", "created_at": "example", "document_hash": "example", "expires_at": "example", "has_proof": true, "has_signed_document": true, "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "labels": [ "example" ], "message": "example", "reminder_count": 1, "reminder_interval_hours": 1, "reminder_max_count": 1, "reply_to": "example", "routing_mode": "example", "sender_name": "example", "signers": [ { "consent_given_at": "example", "created_at": "example", "email": "example", "full_name": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "otp_attempts": 1, "phone": "example", "routing_order": 1, "signed_at": "example", "signed_ip": "example", "status": "example", "token_expires_at": "example", "updated_at": "example", "verification_method": "example" } ], "source_document_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "source_kind": "example", "status": "example", "subject": "example", "updated_at": "example" }, "recipients": 1, "sent": true}No active org.
Generic error body returned by API handlers when they fail. code is a
stable machine-readable token; message is human-friendly and meant for
surfacing to end users.
object
Stable machine token (e.g. invalid_credentials).
Offending request field for validation errors, when known.
Human-readable message.
Example generated
{ "code": "example", "field": "example", "message": "example"}Missing signature:write scope.
Generic error body returned by API handlers when they fail. code is a
stable machine-readable token; message is human-friendly and meant for
surfacing to end users.
object
Stable machine token (e.g. invalid_credentials).
Offending request field for validation errors, when known.
Human-readable message.
Example generated
{ "code": "example", "field": "example", "message": "example"}Not found or cross-org.
Generic error body returned by API handlers when they fail. code is a
stable machine-readable token; message is human-friendly and meant for
surfacing to end users.
object
Stable machine token (e.g. invalid_credentials).
Offending request field for validation errors, when known.
Human-readable message.
Example generated
{ "code": "example", "field": "example", "message": "example"}Envelope is not a draft (signature_conflict) or its document has no rendered PDF yet (document_not_ready).
Generic error body returned by API handlers when they fail. code is a
stable machine-readable token; message is human-friendly and meant for
surfacing to end users.
object
Stable machine token (e.g. invalid_credentials).
Offending request field for validation errors, when known.
Human-readable message.
Example generated
{ "code": "example", "field": "example", "message": "example"}