Creates a new file that can be used in other parts of this API.

This operation returns a put_url property to which you should upload the file via a PUT request.

After uploading a file, you can reference it in other parts of the API by using its full URL in the URL field. For instance, if the file ID is fil_xxxx1, you can use like this in the creation of a document object:

{
  "url": "https://api.signatureapi.com/v1/files/fil_xxxx1",
  ...
}

This URL is provided in the Location header of the response.

​

Returns

Returns a 201 Created status code along with the following attributes:

// POST https://api.signatureapi.com/v1/files
// X-API-Key: key_test_...

{
  "id": "fil_0nZXZ8pYPByQ4XksJbDl4r",
  "put_url": "https://s3.us-east-2.amazonaws.com/signatureapi-vault-dev/temp...",
  "expires_at": "2025-12-31T20:00:00.000Z"
}