Skip to main content
The File resource has been replaced by the Upload resource. The File resource is still available for backward compatibility, but new integrations should use Uploads.
A file is a temporary document stored in SignatureAPI. You can upload a file and then reference it by URL when creating an envelope, for example as the url property of a document. Files are temporary and expire 24 hours after creation. To store files permanently for reuse across multiple envelopes, use the Library in your dashboard.

​
How it works

Creating a file requires two requests:
  1. POST /v1/files to register the file and receive a put_url.
  2. PUT {put_url} to upload the raw file content to that URL.
After completing both steps, reference the file using the URL pattern https://api.signatureapi.com/v1/files/{id}.

​
Attributes

​
id
string
The unique identifier of the file.
​
expires_at
string
The date and time when the file will expire, in format. Files expire 24 hours after creation.
{
  "id": "fil_0nZXZ8pYPByQ4XksJbDl4r",
  "expires_at": "2025-12-31T20:00:00.000Z"
}