{
  "id": "upl_7kWstHtxXmje18omrlV6OA",
  "retention": "temporary",
  "url": "https://api.signatureapi.com/v1/uploads/upl_7kWstHtxXmje18omrlV6OA",
  "format": "docx",
  "sha_256": "89c8b8aec98e905a5f7d5f8cd23f6a9138b05f6f1b50f5429509fafe0fe5b86b",
  "size": 2302931,
  "created_at": "2025-12-30T23:59:59.999Z",
  "expires_at": "2025-12-31T23:59:59.999Z"
}
You can upload files and use them elsewhere in this API, for example as the url property when creating a document. This saves you the trouble of hosting the file yourself. The following file types are supported:
FormatMedia Type
PDFapplication/pdf
DOCXapplication/vnd.openxmlformats-officedocument.wordprocessingml.document
These files are intended for temporary use and expire within 24 hours. To store files you intend to use for longer timeframes, use the Library section in your Dashboard.
The Upload resource is the successor to the File resource. The File resource is soft-deprecated but remains available for backward compatibility.

​
Attributes

​
id
string
The unique identifier of the upload.
​
retention
enum
Whether the upload is permanent or temporary.Available options are permanent and temporary. Uploads made via the API are temporary.
​
url
string
A URL used to reference the uploaded file. This internal URL can be used as input in other fields, like document.url.The file’s content cannot be retrieved directly via this URL.
​
sha_256
string
The SHA-256 hash of the uploaded file in hexadecimal format.
​
size
integer
The size in bytes of the uploaded file.
​
format
enum
The format of the uploaded file.Available options are pdf and docx.
​
created_at
timestamp
The date and time the upload was created in format.
​
expires_at
timestamp
Time at which the file will expire in format.If the upload is has a permanent retention, this value is null.
{
  "id": "upl_7kWstHtxXmje18omrlV6OA",
  "retention": "temporary",
  "url": "https://api.signatureapi.com/v1/uploads/upl_7kWstHtxXmje18omrlV6OA",
  "format": "docx",
  "sha_256": "89c8b8aec98e905a5f7d5f8cd23f6a9138b05f6f1b50f5429509fafe0fe5b86b",
  "size": 2302931,
  "created_at": "2025-12-30T23:59:59.999Z",
  "expires_at": "2025-12-31T23:59:59.999Z"
}