Upload Permanent Files

The Library stores files permanently in your SignatureAPI account. Unlike API uploads which expire after 24 hours, Library files are stored indefinitely and can be reused across multiple envelopes.

The Library supports two types of files:

• Documents (PDF, DOCX) — use as document sources in envelopes. Upload contracts, agreements, and other documents you send repeatedly.
• Images (PNG, JPG) — use as logos for envelope branding. Only images uploaded to your Library can be used as logos.

To manage your files, go to the Library in the Dashboard.

For technical details on the upload resource, see the Upload API reference.

Uploading a file

Using files from the Library

Click Copy URL next to any file to copy its URL. How you use the URL depends on the file type.

Documents in envelopes

Use a PDF or DOCX URL as the url property of a document when creating an envelope:

// POST https://api.signatureapi.com/v1/envelopes
// X-API-Key: key_test_...
// Content-Type: application/json

{
  "title": "Service Agreement",
  "documents": [
    {
      "url": "https://api.signatureapi.com/v1/uploads/upl_7kWstHtxXmje18omrlV6OA#agreement-v1",
      "format": "pdf"
      //...
    }
  ],
  //...
}

Learn more about the different ways to provide document files.

Images for branding

Use a PNG URL as the logo property in envelope branding. The logo appears in the header of recipient emails and the signing ceremony.

// POST https://api.signatureapi.com/v1/envelopes
// X-API-Key: key_test_...
// Content-Type: application/json

{
  "title": "Service Agreement",
  "branding": {
    "logo": "https://api.signatureapi.com/v1/uploads/upl_3joO7lxE8HVhOZmkCHFCxK#company-logo"
  },
  //...
}

Updating a file

To replace a file with a new version, click Update on the Library page. The upload URL stays the same, so any envelope templates or integrations referencing that URL will automatically use the new version.

Deleting a file

To delete a file, click the actions menu (…) next to the file and select Delete. Deleting a file is permanent. Envelopes that were already created with the file are not affected, but the URL can no longer be used in new envelopes.

Library vs API uploads