> ## 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.

# Store an upload

> Convert a temporary upload into a permanent upload that does not expire.

Convert a temporary upload into a permanent upload. The file is moved to permanent storage and no longer expires. A unique `key` is required to identify the permanent upload.

Use this endpoint when you want to reuse a file across multiple envelopes without re-uploading it each time. For example, store a company logo or a contract template that you reference repeatedly.

<Note>
  Once stored, the upload's `retention` changes from `temporary` to `permanent` and the `expires_at` property is removed. The upload `id` and `url` remain the same.
</Note>

## Path Parameters

<ParamField path="uploadId" type="string" required>
  The unique identifier of the upload to store.
</ParamField>

## Body Parameters

<ParamField body="key" type="string" required>
  A unique identifier for the upload within your account. Only lowercase letters, numbers, hyphens, and underscores are allowed. Maximum 100 characters.

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

  {
      "key": "acme-logo"
  }
  ```
</ParamField>

## Returns

Returns a `200 OK` status code and [an upload object](/docs/api/resources/uploads/object) with `retention` set to `permanent`, or an [error](/docs/api/errors) otherwise.

<RequestExample>
  ```bash Request theme={null}
  // POST https://api.signatureapi.com/v1/uploads/{uploadId}/store
  // X-API-Key: key_test_...
  // Content-Type: application/json

  {
      "key": "contract-template-v2"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  // HTTP Status Code 200

  {
    "id": "upl_1sAAaVfabdt0esVjmSTmLA",
    "retention": "permanent",
    "key": "contract-template-v2",
    "url": "https://api.signatureapi.com/v1/uploads/upl_1sAAaVfabdt0esVjmSTmLA",
    "format": "pdf",
    "sha_256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
    "size": 102400,
    "created_at": "2025-12-30T12:00:00.000Z"
  }
  ```
</ResponseExample>