> ## Documentation Index
> Fetch the complete documentation index at: https://signatureapi-daf4ee54.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload Permanent Files

> Upload and manage permanent files for use as document sources in envelopes.

The Library stores files permanently in your SignatureAPI account. Unlike [API uploads](/docs/api/resources/uploads/create) which expire after 24 hours, Library files are stored indefinitely and can be reused across multiple envelopes.

The Library supports two types of files:

* **Documents** (PDF, DOCX) — use as document sources in envelopes. Upload contracts, agreements, and other documents you send repeatedly.
* **Images** (PNG, JPG) — use as logos for [envelope branding](/docs/api/resources/envelopes/branding). Only images uploaded to your Library can be used as logos.

To manage your files, go to the [Library](https://dashboard.signatureapi.com/library) in the Dashboard.

<Frame>
  <img src="https://mintcdn.com/signatureapi-daf4ee54/UqiVROmDb8Tz-1YC/docs/images/upload-library.png?fit=max&auto=format&n=UqiVROmDb8Tz-1YC&q=85&s=06898c5e9c81d8a4c364b8c421ec0795" alt="Library page" width="2880" height="1616" data-path="docs/images/upload-library.png" />
</Frame>

For technical details on the upload resource, see the [Upload API reference](/docs/api/resources/uploads/object).

## Uploading a file

<Steps>
  <Step title="Open the Library">
    Go to the [Library](https://dashboard.signatureapi.com/library) in the Dashboard.
  </Step>

  <Step title="Upload the file">
    Click **Upload a file** or drag and drop a file into the upload area. Supported formats:

    | Format | Max size |
    | :----- | :------- |
    | PDF    | 10 MB    |
    | DOCX   | 10 MB    |
    | PNG    | 10 MB    |
    | JPG    | 10 MB    |
  </Step>

  <Step title="Set the key">
    Each file gets a unique key that identifies it within your account. The key appears in the file list and is part of the upload URL. You can edit the key by clicking the edit icon next to it.

    Keys can contain lowercase letters, numbers, hyphens, and underscores (max 100 characters).
  </Step>
</Steps>

## Using files from the Library

Click **Copy URL** next to any file to copy its URL. How you use the URL depends on the file type.

### Documents in envelopes

Use a PDF or DOCX URL as the `url` property of a [document](/docs/api/resources/documents/object) when creating an envelope:

```json theme={null}
// POST https://api.signatureapi.com/v1/envelopes
// X-API-Key: key_test_...
// Content-Type: application/json

{
  "title": "Service Agreement",
  "documents": [
    {
      "url": "https://api.signatureapi.com/v1/uploads/upl_7kWstHtxXmje18omrlV6OA#agreement-v1",
      "format": "pdf"
      //...
    }
  ],
  //...
}
```

Learn more about the different ways to [provide document files](/docs/api/resources/documents/url).

### Images for branding

Use a PNG URL as the `logo` property in [envelope branding](/docs/api/resources/envelopes/branding). The logo appears in the header of recipient emails and the signing ceremony.

```json theme={null}
// POST https://api.signatureapi.com/v1/envelopes
// X-API-Key: key_test_...
// Content-Type: application/json

{
  "title": "Service Agreement",
  "branding": {
    "logo": "https://api.signatureapi.com/v1/uploads/upl_3joO7lxE8HVhOZmkCHFCxK#company-logo"
  },
  //...
}
```

<Note>Only images uploaded to your Library can be used as logos. External URLs are not supported.</Note>

## Updating a file

To replace a file with a new version, click **Update** on the Library page. The upload URL stays the same, so any envelope templates or integrations referencing that URL will automatically use the new version.

## Deleting a file

To delete a file, click the actions menu (**...**) next to the file and select **Delete**. Deleting a file is permanent. Envelopes that were already created with the file are not affected, but the URL can no longer be used in new envelopes.

## Library vs API uploads

|             | Library (permanent)                              | API upload (temporary)                             |
| :---------- | :----------------------------------------------- | :------------------------------------------------- |
| Created via | Dashboard                                        | [API endpoint](/docs/api/resources/uploads/create) |
| Retention   | Stored indefinitely                              | Expires after 24 hours                             |
| Reusable    | Yes — use the same URL across multiple envelopes | No — intended for one-time use                     |
| Best for    | Recurring documents, templates, logos            | One-off sends from your application                |

<Note>You need the **Manage document library** permission to upload or delete files. See [Manage Team Members](/docs/dashboard/users) for details on roles and permissions.</Note>