Deprecated fields

You can now download files through dedicated endpoints using your API key. Each download request uses standard API authentication, giving you a consistent way to retrieve:

You can find more information in Download files.

Deprecated fields

The following download URL fields are now deprecated. Use the corresponding endpoint to download each file:

Deprecated field	Replacement endpoint
`envelope_documents[].document_signed_pdf`	`GET /envelopes/{envelope_fingerprint}/documents/{document_fingerprint}/download`
`envelope_documents[].document_pdf_url`	`GET /envelopes/{envelope_fingerprint}/documents/{document_fingerprint}/original/download`
`envelope_signed_pdf`	`GET /envelopes/{envelope_fingerprint}/download`
`templates[].template_pdf_url`	`GET /templates/{fingerprint}/download`
`template_pdf_url`	`GET /templates/{fingerprint}/download`

Customers joining from 30 September 2026 must use the download endpoints. The deprecated fields are not available to these customers.

Existing customers can continue using the deprecated fields, with no migration deadline currently set. We will introduce API versioning first so you can migrate your integration before support for these fields ends.

Upload field values

For new customers joining from 30 September 2026, envelope_documents[].document_fields[].field_value will no longer return a file URL when field_type is upload. Instead, it will return the following message:

{
  "field_value": "Files have been uploaded. Download them via the authenticated API: https://api.signable.co.uk/v1/envelopes/{associated-envelope-fingerprint}/download"
}

Use the Upload field files endpoint to download these files.