---
title: "File"
description: "The file resource (deprecated). Use the Upload resource instead."
canonical: "https://signatureapi.com/docs/api/resources/files/object"
source: "https://signatureapi.com/docs/api/resources/files/object.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T17:22:42Z"
---

# File

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

_Last verified against API version 1.18.0._

> **Deprecated:** The File resource is replaced by the [Upload resource](https://signatureapi.com/docs/api/resources/uploads/object). It still works for existing integrations; new integrations use [Create an upload](https://signatureapi.com/docs/api/resources/uploads/create) and [Get an upload](https://signatureapi.com/docs/api/resources/uploads/get).

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](https://signatureapi.com/docs/api/resources/documents/object).

Files are temporary and expire 24 hours after creation. To store files permanently for reuse across multiple envelopes, use the [Library](https://dashboard.signatureapi.com/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 ISO 8601 format. Files expire 24 hours after creation.

### Example: Standard

Response 200 OK:

```json
{
  "id": "fil_0nZXZ8pYPByQ4XksJbDl4r",
  "expires_at": "2026-11-02T15:03:11.000Z"
}
```
