Preview
POST /api/v1/signature-packages/preview requires packages:create.
preview_token, version, and prepared_pdf. pdf_url_is_source:true means pdf_url points to the source, not the populated preview.
Review, then send
POST/signature-packages/preview/document with template_id and preview_token for the populated PDF. Show the sender the PDF, values, recipients, and expiry. The context-bound receipt is valid for 10 minutes.
After sender confirmation, POST /signature-packages with packages:create, an idempotency key, and:
201 and invitation_status:"queued" mean queued delivery, not delivered email or completed consent.
Status and archive
GET /signature-packages supports q, status, archived=only, and pagination. Details use GET /signature-packages/{id}. Both require packages:read.
POST /signature-packages/{id}/archive requires packages:archive, a 5–500-character reason, and an idempotency key. Packages must be terminal; active packages return PACKAGE_NOT_CLOSED. Evidence is retained.
The internal_dekasign profile is not a PSrE certificate or trusted timestamp.