Topolo Docs Topolo Platform
Open workspace

Download completed Sign agreement

Read the immutable completed PDF only after the exact envelope is completed and its retained artifact is ready. The SDK returns contentType, contentLength and contentBase64.

Outcome

Read the immutable completed PDF only after the exact envelope is completed and its retained artifact is ready. The SDK returns contentType, contentLength and contentBase64.

Before you start

  • Verify the environment, authenticated identity and specifically approved organization context.
  • The published application permission is workspace:read. Resolve and bind the exact canonical Sign workspace. A supplied id or organization membership alone grants no workspace access.
  • Session callers require read workspace access. API-key resource binding is verified by Auth; never treat a caller-supplied header as an independent grant.

Discover the target

topolo whoami --json
topolo actions get app_topolo_sign.envelopes.completed_document.get --detail --json
topolo resources topolo-sign --json
topolo workspaces list topolo-sign --json
  • Set SIGN_WORKSPACE_ID to the exact granted workspace returned by discovery.
  • Resolve envelopeId through envelopes.list/get or retain the exact creation response.

Request

GET /api/envelopes/{envelopeId}/completed-document

Inspect and test this action. Save the reviewed input as payload.json. Supply resource context separately.

Input fields

FieldRequiredMeaningConstraints
envelopeIdRequiredExact envelope.id returned by creation or envelopes.list/get in this workspace.{"minLength":1}

Read the complete input schema.

Effects

  • Reads retained bytes with existing workspace:read authorization. No agreement, consent or recipient data is changed.
  • The server verifies stored object SHA-256 before returning bytes. Artifact download records an existing operational download event.

Interpret the response

Binary transport returns no resource identifier. Retain the authorized input documentId or envelopeId; decoded bytes are the downloaded artifact.

Read envelopes.audit_certificate.get with the retained envelopeId in the same granted workspace. Base64-decode contentBase64 and compare its byte length with contentLength. SHA-256 the decoded bytes and compare with artifacts[].sha256 for kind completed_pdf from the authorized metadata read. Never hash the Base64 string. The SDK binary projection contains bytes and type, not a new document id or filename. Retain the input identifier and choose a local filename deliberately.

Inspect the success schema. CLI/MCP add their transport envelope; --detail requests the full CLI result. HTTP 204 contains no JSON payload.

Worked examples

Captured from the exported Sign Worker with the existing SQLite-backed D1 harness applying all core, envelope and audit migrations to one local database, in-memory R2 and synthetic Auth/workspace/archive/Notify transports. These examples prove local validation, persistence and artifact production. They do not prove separate deployed D1 topology, real recipient consent, provider delivery or a live signed agreement. All identities, signing links and documents are synthetic; replace identifiers through authorized discovery and never execute a fixture against a live organization. Binary download examples use the released SDK binary projection; tests Base64-decode and compare original bytes, lengths and server SHA-256 headers.

Refused request · HTTP 409

Input · payload.json:

{
  "envelopeId": "b0db0353-6d5a-4a9b-b3f4-85f439ec4953"
}

CLI:

topolo actions validate app_topolo_sign.envelopes.completed_document.get --data @payload.json --json
topolo actions plan app_topolo_sign.envelopes.completed_document.get --resource-type workspace --resource-id "$SIGN_WORKSPACE_ID" --data @payload.json --json

Captured exported Worker response · HTTP 409:

{
  "error": "completed_document_not_ready"
}

HTTP 409. Resolve the exact refusal before retrying. This request is not a successful workflow.

Supported request · Read the immutable completed PDF and verify its SHA-256

Input · payload.json:

{
  "envelopeId": "b0db0353-6d5a-4a9b-b3f4-85f439ec4953"
}

CLI:

topolo actions validate app_topolo_sign.envelopes.completed_document.get --data @payload.json --json
topolo actions plan app_topolo_sign.envelopes.completed_document.get --resource-type workspace --resource-id "$SIGN_WORKSPACE_ID" --data @payload.json --json
topolo actions call app_topolo_sign.envelopes.completed_document.get --resource-type workspace --resource-id "$SIGN_WORKSPACE_ID" --data @payload.json --detail --json

MCP tool and arguments:

{
  "tool": "topolo_read_action",
  "arguments": {
    "actionId": "app_topolo_sign.envelopes.completed_document.get",
    "input": {
      "envelopeId": "b0db0353-6d5a-4a9b-b3f4-85f439ec4953"
    },
    "resourceType": "workspace",
    "resourceId": "<exact granted id from discovery>",
    "detail": true
  }
}

Captured canonical SDK binary projection of the exported Worker response · HTTP 200:

{
  "contentType": "application/pdf",
  "contentLength": 4285,
  "contentBase64": "JVBERi0xLjcKJYGBgYEKCjEgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFsgNSAwIFIgMTUgMCBSIF0KL0NvdW50IDIKPj4KZW5kb2JqCgoyIDAgb2JqCjw8Ci9UeXBlIC9DYXRhbG9nCi9QYWdlcyAxIDAgUgovQWNyb0Zvcm0gNyAwIFIKL1ZpZXdlclByZWZlcmVuY2VzIDE3IDAgUgo+PgplbmRvYmoKCjMgMCBvYmoKPDwKL1Byb2R1Y2VyIDxGRUZGMDA1NDAwNkYwMDcwMDA2RjAwNkMwMDZGMDAyMDAwNTMwMDY5MDA2NzAwNkU+Ci9Nb2REYXRlIChEOjIwMjYxMDA1MTgwNzQwWikKL0NyZWF0b3IgPEZFRkYwMDU0MDA2RjAwNzAwMDZGMDA2QzAwNkYwMDIwMDA1MzAwNjkwMDY3MDA2RT4KL0NyZWF0aW9uRGF0ZSAoRDoyMDI2MTAwNTE4MDc0MFopCi9UaXRsZSA8RkVGRjAwNDYwMDY5MDA3ODAwNzQwMDc1MDA3MjAwNjUwMDIwMDA2MTAwNjcwMDcyMDA2NTAwNjUwMDZEMDA2NTAwNkUwMDc0PgovU3ViamVjdCA8RkVGRjAwNTQwMDZGMDA3MDAwNkYwMDZDMDA2RjAwMjAwMDUzMDA2OTAwNjcwMDZFMDAyMDAwNjUwMDZFMDA3NjAwNjUwMDZDMDA2RjAwNzAwMDY1MDAyMDAwNjIwMDMwMDA2NDAwNjIwMDMwMDAzMzAwMzUwMDMzMDAyRDAwMzYwMDY0MDAzNTAwNjEwMDJEMDAzNDAwNjEwMDM5MDA2MjAwMkQwMDYyMDAzMzAwNjYwMDM0MDAyRDAwMzgwMDM1MDA2NjAwMzQwMDMzMDAzOTAwNjUwMDYzMDAzNDAwMzkwMDM1MDAzMz4KL0tleXdvcmRzIDxGRUZGMDA2NTAwNkUwMDc2MDA2NTAwNkMwMDZGMDA3MDAwNjUwMDNBMDA2MjAwMzAwMDY0MDA2MjAwMzAwMDMzMDAzNTAwMzMwMDJEMDAzNjAwNjQwMDM1MDA2MTAwMkQwMDM0MDA2MTAwMzkwMDYyMDAyRDAwNjIwMDMzMDA2NjAwMzQwMDJEMDAzODAwMzUwMDY2MDAzNDAwMzMwMDM5MDA2NTAwNjMwMDM0MDAzOTAwMzUwMDMzMDAyMDAwNzMwMDZGMDA3NTAwNzIwMDYzMDA2NTAwMkQwMDczMDA2ODAwNjEwMDMyMDAzNTAwMzYwMDNBMDA2MjAwNjMwMDM3MDAzNTAwNjEwMDMxMDA2MjAwMzEwMDYxMDA2NDAwMzQwMDY0MDAzNDAwMzEwMDYxMDAzMjAwMzcwMDM1MDA2NTAwMzMwMDYxMDAzNDAwNjQwMDYxMDA2NDAwNjQwMDM5MDA2MTAwMzYwMDMwMDAzMzAwMzEwMDY1MDAzMDAwNjMwMDM1MDAzNjAwMzAwMDMyMDAzOTAwNjUwMDM0MDAzODAwMzYwMDY1MDAzNDAwMzcwMDYxMDAzMTAwMzgwMDMxMDA2MjAwNjEwMDM4MDAzNDAwMzgwMDM5MDAzMTAwNjEwMDYzMDA2MzAwMzkwMDM3MDA2Nj4KPj4KZW5kb2JqCgo0IDAgb2JqCjw8Ci9UeXBlIC9Gb250Ci9TdWJ0eXBlIC9UeXBlMQovQmFzZUZvbnQgL0hlbHZldGljYQovRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwo+PgplbmRvYmoKCjUgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAxIDAgUgovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9IZWx2ZXRpY2EtNzA5ODQ4MDc4OSA0IDAgUgovVGltZXMtQm9sZEl0YWxpYy03MDk4NDgwNzg5IDExIDAgUgovSGVsdmV0aWNhLTk3NDI2ODI1NjggOSAwIFIKPj4KL1hPYmplY3QgPDwKPj4KL0V4dEdTdGF0ZSA8PAo+Pgo+PgovTWVkaWFCb3ggWyAwIDAgNjEyIDc5MiBdCi9Bbm5vdHMgWyBdCi9Db250ZW50cyBbIDEyIDAgUiA2IDAgUiAxMyAwIFIgMTQgMCBSIF0KPj4KZW5kb2JqCgo2IDAgb2JqCjw8Ci9GaWx0ZXIgL0ZsYXRlRGVjb2RlCi9MZW5ndGggMTA2Cj4+CnN0cmVhbQp4nB2KsQrCQBAF+/cVWwvi7nm37w7EQhAsbIT9AZEkGGKhSL4/RgaGKeaNU0Bl5TNgd+mmufs+H/cttdVclbWJZYke6ecr7L+aMAlVJV44ZPfGyszC5CUp1c251t6OEiNig3PghgVBgheLCmVuZHN0cmVhbQplbmRvYmoKCjcgMCBvYmoKPDwKL0ZpZWxkcyBbIF0K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"
}

HTTP 200. Read envelopes.audit_certificate.get with the retained envelopeId in the same granted workspace. Base64-decode contentBase64 and compare its byte length with contentLength. SHA-256 the decoded bytes and compare with artifacts[].sha256 for kind completed_pdf from the authorized metadata read. Never hash the Base64 string. The SDK binary projection contains bytes and type, not a new document id or filename. Retain the input identifier and choose a local filename deliberately.

Refused request · HTTP 401

Input · payload.json:

{
  "envelopeId": "ed22fca5-d5f0-4392-8e71-96e247bf3875"
}

CLI:

topolo actions validate app_topolo_sign.envelopes.completed_document.get --data @payload.json --json
topolo actions plan app_topolo_sign.envelopes.completed_document.get --resource-type workspace --resource-id "$SIGN_WORKSPACE_ID" --data @payload.json --json

Captured exported Worker response · HTTP 401:

{
  "error": "Token validation failed"
}

HTTP 401. Resolve the exact refusal before retrying. This request is not a successful workflow.

Refused request · HTTP 403

Input · payload.json:

{
  "envelopeId": "synthetic-unresolved-fixture"
}

CLI:

topolo actions validate app_topolo_sign.envelopes.completed_document.get --data @payload.json --json
topolo actions plan app_topolo_sign.envelopes.completed_document.get --resource-type workspace --resource-id "$SIGN_WORKSPACE_ID" --data @payload.json --json

Captured exported Worker response · HTTP 403:

{
  "error": "You do not have access to this workspace",
  "code": "workspace_forbidden"
}

HTTP 403. Resolve the exact refusal before retrying. This request is not a successful workflow.

Verify the result

  • Read envelopes.audit_certificate.get with the retained envelopeId in the same granted workspace.
  • Base64-decode contentBase64 and compare its byte length with contentLength. SHA-256 the decoded bytes and compare with artifacts[].sha256 for kind completed_pdf from the authorized metadata read. Never hash the Base64 string.
  • The SDK binary projection contains bytes and type, not a new document id or filename. Retain the input identifier and choose a local filename deliberately.

Errors and recovery

  • envelope_not_found (HTTP 404): Discover the exact retained identifier in this authorized workspace; do not substitute an identifier from another workspace.
  • artifact_integrity_failed (HTTP 500): Stored artifact bytes do not match the retained SHA-256. Preserve the envelope, expected hash and request id and report the integrity incident; do not substitute a new hash.
  • completed_document_not_ready (HTTP 409): Read the retained envelope and restore the complete intended recipient list through an authorized draft update before attempting send.
  • auth_error (HTTP 401): Reauthenticate in the same approved context before retrying.
  • workspace_forbidden (HTTP 403): Discover the actual workspace grant and obtain the documented required access; do not retry with a guessed workspace or broader organization.

Some existing refusals return a human message as error rather than a stable code; preserve the actual response, status and request id. Platform validation, authentication and resource checks can refuse before the handler.

Recovery boundary

A download changes no agreement. Resolve the actual grant and artifact readiness, then repeat the same read. Never recreate or re-sign an agreement to make a download succeed.

  • Get Sign audit certificate: Get the immutable audit certificate issued when an envelope completed: signer identities, capacities, consent and evidence hashes, the source and completed document SHA-256 and a hash chain over the audit trail, plus the certificate's own hash.

Evidence

Captured from the exported Sign Worker with the existing SQLite-backed D1 harness applying all core, envelope and audit migrations to one local database, in-memory R2 and synthetic Auth/workspace/archive/Notify transports. These examples prove local validation, persistence and artifact production. They do not prove separate deployed D1 topology, real recipient consent, provider delivery or a live signed agreement. All identities, signing links and documents are synthetic; replace identifiers through authorized discovery and never execute a fixture against a live organization. Binary download examples use the released SDK binary projection; tests Base64-decode and compare original bytes, lengths and server SHA-256 headers.