List Edits

HTTP Method: GET URL: /api/v3/edits Authentication: Requires API Key in the request header. Authorization: Only edits belonging to the account associated with the API token are returned. When studioId or projectId filters are supplied, the studio/project must belong to the account. Query Parameters:

Parameter	Type	Description
`studioId`	string	Filter edits by studio ID
`projectId`	string	Filter edits by project ID
`start_date`	string	Only return edits created on or after this date (ISO-8601). Example: `2025-10-01T00:00:00Z`
`end_date`	string	Only return edits created on or before this date (ISO-8601). Must be greater than or equal to `start_date`.
`page`	integer	Page number (starts from 1)

Response: Paginated list of edit objects for the account. Rate limit: Once every 1 second for unique requests. Pagination: This endpoint uses page-based pagination with a fixed page size of 20 edits. To iterate through all results:

Make the first request without a page parameter (defaults to page 1).
If next_page_url is not null, request the next page (either follow next_page_url or increment page).
Repeat until next_page_url is null.

Status Codes:

200 OK Edits retrieved successfully.
401 Unauthorized Authentication failed (missing or invalid API token).
429 Too Many Requests This endpoint is rate limited.
500 Internal Server Error Unexpected server error.

Sample Request

GET /api/v3/edits HTTP/1.1
Host: platform.riverside.fm
Authorization: Bearer YOUR_API_KEY

Sample Request with filters

GET /api/v3/edits?studioId=640479c9-1222-4161-1234-dee0d855e685&start_date=2025-10-01T00:00:00Z&end_date=2025-10-31T23:59:59Z&page=2 HTTP/1.1
Host: platform.riverside.fm
Authorization: Bearer YOUR_API_KEY

Sample Response

{
  "page": 1,
  "next_page_url": "https://platform.riverside.fm/api/v3/edits?page=2",
  "total_items": 200,
  "total_pages": 10,
  "data": [
    {
      "clip_id": "6618c2e4f2a9b8001234abcd",
      "name": "Episode 12 – Final",
      "project_id": "6618c2e4f2a9b800123424tt",
      "studio_id": "6618c2e4f2a9b80012342444",
      "created_date": "2025-10-05T12:00:00Z",
      "status": "exported",
      "download_url": "https://platform.riverside.fm/api/v3/download/export/6618c2e4f2a9b8001234abcd"
    },
    {
      "clip_id": "6618c2e4f2a9b80012342460",
      "name": "Episode 11 – Draft",
      "project_id": "6618c2e4f2a9b800123424tt",
      "studio_id": "6618c2e4f2a9b80012342444",
      "created_date": "2025-10-05T12:00:00Z",
      "status": "draft",
      "download_url": null
    }
  ]
}

Getting Started

Endpoints Reference

Webhooks

Objects Reference

Sample Request

Sample Request with filters

Sample Response

​Sample Request

​Sample Request with filters

​Sample Response

Sample Request

Sample Request with filters

Sample Response