Skip to main content
GET
/
automation
/
get-all-presets
Get All Presets
curl --request GET \
  --url https://public.reap.video/api/v1/automation/get-all-presets \
  --header 'Authorization: Bearer <token>'
{
  "presets": [
    {
      "id": "<string>",
      "name": "<string>",
      "source": "system",
      "preferences": {
        "addAudiogram": false,
        "addCaptions": true,
        "genre": "talking",
        "language": "en",
        "translationLanguage": "<string>",
        "transcriptionScript": "native",
        "orientation": "landscape",
        "resolution": 720,
        "clipDurations": [
          [
            123
          ]
        ]
      }
    }
  ],
  "currentPage": 123,
  "totalPages": 123,
  "totalPresets": 123
}

​
Overview

Get a paginated list of all caption presets available in your studio. Presets define the styling, animation, and visual presentation of captions that can be applied to your video projects.

​
Response

​
presets
array
Array of preset objects
​
currentPage
integer
Current page number
​
totalPages
integer
Total number of pages available
​
totalPresets
integer
Total number of presets in your studio

​
Example Request

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

​
Example Response

​
Rate Limiting

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

​
Preset Types

Caption presets control various aspects of subtitle presentation:
  • Typography: Font family, size, weight, and color
  • Positioning: Caption placement and alignment on screen
  • Animation: Text entrance and exit effects
  • Background: Caption background styling and transparency
  • Highlighting: Keyword emphasis and emoji integration

​
Common Use Cases

Custom Caption Styles

Choose from your own caption styles when creating video projects

Preset Validation

Validate preset IDs before creating video projects

Brand Consistency

Maintain consistent caption styling across all your video content

Style Previews

Display caption style previews to help users choose the right visual presentation

​
Error Responses

​
401
error
Unauthorized - Invalid or missing API key
​
429
error
Too Many Requests - Rate limit exceeded
​
500
error
Internal Server Error - Something went wrong on our end

​
Next Steps

Once you have your presets, you can use them when creating video 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 presets per page (max 100)

Response

200 - application/json

Successful response

​
presets
object[]
​
currentPage
integer
​
totalPages
integer
​
totalPresets
integer