Deprecated Files

File

The file resource (deprecated). Use the Upload resource instead.

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"
}