GET
/
api
/
v1
/
automation
/
get-all-uploads
Get All Uploads
curl --request GET \
  --url https://public.reap.video/api/v1/automation/get-all-uploads \
  --header 'Authorization: Bearer <token>'
{
  "uploads": [
    {
      "id": "<string>",
      "fileName": "<string>",
      "fileType": "<string>",
      "fileSize": 123,
      "contentType": "<string>",
      "status": "<string>",
      "createdAt": 123,
      "updatedAt": 123
    }
  ],
  "currentPage": 123,
  "totalPages": 123,
  "totalUploads": 123,
  "upload": {},
  "verified": {},
  "rejected": {}
}

Overview

Get a paginated list of all files uploaded to your studio via the Upload API. This endpoint helps you track upload status, manage files, and retrieve upload IDs for use in video projects.

Query Parameters

page
integer
default:"1"

Page number for pagination

pageSize
integer
default:"10"

Number of uploads to return per page (maximum 100)

Response

uploads
array

Array of upload objects

currentPage
integer

Current page number

totalPages
integer

Total number of pages available

totalUploads
integer

Total number of uploads in your studio

Upload Status Values

upload
status

File upload URL has been generated but file hasn’t been uploaded yet

verified
status

File has been successfully uploaded and validated when first used in a project - ready for reuse

rejected
status

File upload failed validation (invalid format, too large, corrupted, etc.)

Example Request

curl -X GET "https://public.reap.video/api/v1/automation/get-all-uploads?page=1&pageSize=20" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Example Response

Filtering and Management

Upload Status Filtering

You can filter uploads by status to find specific files:

  • Verified uploads - Successfully validated when first used, ready for reuse
  • Pending uploads - Upload URL generated but file not uploaded yet
  • Rejected uploads - Failed validation and cannot be used

File Management

Use this endpoint to:

Track Upload Progress

Monitor which files have been successfully uploaded and their validation status

Manage Storage

Review file sizes and manage your storage usage

Retrieve Upload IDs

Get upload IDs for use in project creation endpoints

Debug Upload Issues

Identify rejected uploads and troubleshoot problems

Rate Limiting

This endpoint is subject to the standard rate limit of 10 requests per minute.

Common Use Cases

Upload Management

Track upload status and find verified files for reuse in projects

File Management UI

Build upload management interfaces in your application

Batch Processing

Process multiple uploaded files in batch operations

Storage Analytics

Analyze upload patterns and storage usage

Next Steps

Once you have upload IDs from verified uploads, you can use them to create projects: