tasks

Attach the document to sign

Attach (or replace, before anyone signs) the document a response_type "signature" task asks the worker to read and sign with their passkey. The server stores the bytes privately and records their SHA-256; that hash is inside every signature challenge, so a signature proves which exact document was signed. Replacing bumps version; a document is frozen once a signature lands. Write tier (API key or an owner/admin session).

put/tasks/{id}/signature-doc

Request

  • Base URL: https://app.tascan.io/api/v1
  • URL: https://app.tascan.io/api/v1/tasks/{id}/signature-doc
  • Auth: HTTP bearer

Path parameters

idstring required

Request body

doc_base64string required

The document bytes, base64 (at most 10 MB).

mime'application/pdf' | 'image/png' | 'image/jpeg' required
signer_scope'any_list_worker' | 'assigned_worker'

Who may sign: any worker on the list (default) or only the assigned worker.

consent_text_idstring

Consent text shown before signing (default esign-v1).

Response

{ data: { doc_sha256, version, mime, bytes, signer_scope, consent_text_id } } (the storage path is never returned)

Changes

No recorded changes to this operation across all 1 revision of this API.