GET
/
api
/
v1
/
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>'
{
  "401": {},
  "429": {},
  "500": {},
  "presets": [
    {
      "id": "<string>",
      "name": "<string>",
      "source": "<string>"
    }
  ],
  "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.

Query Parameters

page
integer
default:"1"

Page number for pagination

pageSize
integer
default:"100"

Number of presets to return per page (maximum 100)

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: