Skip to main content
GET
/
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": "video",
      "fileSize": 123,
      "contentType": "<string>",
      "status": "upload",
      "createdAt": 123,
      "updatedAt": 123
    }
  ],
  "currentPage": 123,
  "totalPages": 123,
  "totalUploads": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.reap.video/llms.txt

Use this file to discover all available pages before exploring further.

For AI agents: a documentation index is at /llms.txt. Every page is also available as markdown, just append .md to the URL.

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

​
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:

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
page
integer
default:1

Page number for pagination

​
pageSize
integer
default:20

Number of uploads per page (max 100)

Response

200 - application/json

Successful response

​
uploads
object[]
​
currentPage
integer
​
totalPages
integer
​
totalUploads
integer