Get all unused upload URLs | FastPix Developer Documentation

{
  "success": true,
  "data": [
    {
      "uploadId": "9149264c-6cb9-40d3-9313-95a85c56135e",
      "trial": true,
      "status": "waiting",
      "url": "https://storage.fastpix.net/uploads/7619ee69-d758-4589-80ee-965f6bfc922c/9149264c-6cb9-40d3-9313-95a85c56135e?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=assets-svc%2F20250109%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250109T084749Z&X-Amz-Expires=14400&X-Amz-SignedHeaders=host&X-Amz-Signature=f0a1e3798792543bff7fed64314cc386f56adc1bc1a65f6d4d9c137c6998b6ce",
      "timeout": 14400,
      "corsOrigin": "*",
      "pushMediaSettings": {
        "playbackIds": [
          {
            "accessPolicy": "public",
            "accessRestrictions": {
              "domains": {
                "defaultPolicy": "allow",
                "allow": [],
                "deny": []
              },
              "userAgents": {
                "defaultPolicy": "allow",
                "allow": [],
                "deny": []
              }
            }
          }
        ],
        "metadata": {
          "key1": "value1"
        },
        "mediaQuality": "standard"
      }
    }
  ],
  "pagination": {
    "totalRecords": 100,
    "currentOffset": 1,
    "offsetCount": 10
  }
}

An unused upload URL is a signed URL that gets generated when an user initiates upload but never completed the upload process. This can happen due to reasons like network issues, manual cancellation of upload, browser/app crashes or session timeouts.These URLs remain in the system as “unused” since they were created but never resulted in a successful media file upload.

How it works

The endpoint returns metadata for all unused upload URLs in your organization’s library.
Results are paginated to manage large datasets effectively.
Signed URLs expire after 24 hours from creation.
Each entry includes full metadata about the unused upload.

Example

A video management team at a media organization regularly uploads content but often forgets to delete or use unused uploads. These unused uploads have signed URLs that expire after 24 hours and need to be managed efficiently. By using this API, the team can retrieve metadata for all unused uploads, identify expired signed URLs, and decide whether to regenerate URLs, reuse the uploads, or delete them.

This endpoint retrieves a paginated list of all unused upload signed URLs within your organization. It provides comprehensive metadata including upload IDs, creation dates, status, and URLs, helping you manage your media resources efficiently. An unused upload URL is a signed URL that gets generated when an user initiates upload but never completed the upload process. This can happen due to reasons like network issues, manual cancellation of upload, browser/app crashes or session timeouts.These URLs remain in the system as "unused" since they were created but never resulted in a successful media file upload. #### How it works - The endpoint returns metadata for all unused upload URLs in your organization's library. - Results are paginated to manage large datasets effectively. - Signed URLs expire after 24 hours from creation. - Each entry includes full metadata about the unused upload. #### Example A video management team at a media organization regularly uploads content but often forgets to delete or use unused uploads. These unused uploads have signed URLs that expire after 24 hours and need to be managed efficiently. By using this API, the team can retrieve metadata for all unused uploads, identify expired signed URLs, and decide whether to regenerate URLs, reuse the uploads, or delete them.

Authentication

AuthorizationBasic

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request.

Username: Access Token ID
Password: Secret Key

Activate your FastPix account to generate your API credentials. See the guide here

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request. - <b>Username:</b> Access Token ID - <b>Password:</b> Secret Key Activate your FastPix account to generate your API credentials. <a href="https://docs.fastpix.io/docs/activate-account" target="_blank">See the guide here</a>

Query parameters

limitintegerOptional1-50Defaults to 10

Limit specifies the maximum number of items to display per page.

offsetintegerOptionalDefaults to 1

Offset determines the starting point for data retrieval within a paginated list.

orderByenumOptionalDefaults to desc

The values in the list can be arranged in two ways: DESC (Descending) or ASC (Ascending).

Allowed values:

Response

List of video media

successboolean

Shows the request status. Returns true for success and false for failure.

datalist of objects

Displays the result of the request.

paginationobject

Pagination organizes content into pages for better readability and navigation.

How it works

The endpoint returns metadata for all unused upload URLs in your organization’s library.
Results are paginated to manage large datasets effectively.
Signed URLs expire after 24 hours from creation.
Each entry includes full metadata about the unused upload.

$	curl https://api.fastpix.com/v1/on-demand/uploads \
>	-u "<username>:<password>"