> ## Documentation Index
> Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Save a text preset

> Saves a personal text preset, like the editor's "Save style" on a text overlay. The style starts from an existing text overlay when `videoId` and `textOverlayId` are given (keeping a custom font and reading the size relative to that video's canvas), else from the editor's default text look; every style field sent alongside overrides it. The preset then appears in GET /v1/text-presets and in the editor's Text panel.



## OpenAPI

````yaml /openapi.json post /v1/text-presets
openapi: 3.0.3
info:
  description: >-
    The Tella Public API allows you to programmatically access your videos and
    playlists, including transcripts, chapters, and thumbnails.


    ## Authentication


    All requests require a Bearer token in the Authorization header:

    ```

    Authorization: Bearer tella_pk_xxxxx...

    ```


    API keys can be generated in your Tella workspace settings.


    ## Rate Limiting


    The API is rate-limited to 100 requests per minute per user within a
    workspace.

    Rate limit information is returned in response headers:

    - `RateLimit-Policy`: Named quota, request limit, and window in seconds

    - `RateLimit`: Remaining quota and seconds until reset

    - `X-RateLimit-Limit`: Maximum requests per window

    - `X-RateLimit-Remaining`: Remaining requests in current window

    - `X-RateLimit-Reset`: Unix timestamp in milliseconds when the window resets


    A `429 Too Many Requests` response also includes `Retry-After` in seconds.
  title: Tella Public API
  version: 1.0.0
servers:
  - description: Production
    url: https://api.tella.com
security: []
tags:
  - description: Video operations
    name: Videos
  - description: Sections of a video
    name: Clips
  - description: Playlist operations
    name: Playlists
  - description: Sidebar groups for organizing playlists
    name: Playlist Groups
  - description: Tags for categorizing and filtering videos
    name: Tags
  - description: >-
      Viewing analytics for a video or across the workspace: plays, watch time,
      retention, geography, referrers
    name: Analytics
  - description: Personal, workspace, and default video backgrounds
    name: Backgrounds
  - description: >-
      Reusable media saved to a workspace, plus Tella's curated sound effect and
      background music catalogs — the same items the editor's media panels show
    name: Library
  - description: Webhook endpoint management
    name: Webhooks
externalDocs:
  description: API versioning and deprecation policy
  url: https://www.tella.com/docs/versioning
paths:
  /v1/text-presets:
    post:
      tags:
        - Clips
      summary: Save a text preset
      description: >-
        Saves a personal text preset, like the editor's "Save style" on a text
        overlay. The style starts from an existing text overlay when `videoId`
        and `textOverlayId` are given (keeping a custom font and reading the
        size relative to that video's canvas), else from the editor's default
        text look; every style field sent alongside overrides it. The preset
        then appears in GET /v1/text-presets and in the editor's Text panel.
      operationId: saveTextPreset
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SaveTextPresetRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  preset:
                    $ref: '#/components/schemas/TextPreset'
                required:
                  - preset
                type: object
          description: Preset saved
          headers:
            Deprecation:
              $ref: '#/components/headers/Deprecation'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            Sunset:
              $ref: '#/components/headers/Sunset'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/XRateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/XRateLimitReset'
        '400':
          content:
            application/json:
              example:
                docsUrl: https://docs.tella.com/
                error: bad_request
                message: The request was malformed or contained invalid parameters.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: The request was malformed or contained invalid parameters.
          headers:
            Deprecation:
              $ref: '#/components/headers/Deprecation'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            Sunset:
              $ref: '#/components/headers/Sunset'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/XRateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/XRateLimitReset'
        '401':
          content:
            application/json:
              example:
                docsUrl: https://docs.tella.com/
                error: unauthorized
                message: Authentication is required. Provide a valid API key.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Authentication is required. Provide a valid API key.
          headers:
            Deprecation:
              $ref: '#/components/headers/Deprecation'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            Sunset:
              $ref: '#/components/headers/Sunset'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/XRateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/XRateLimitReset'
        '403':
          content:
            application/json:
              example:
                docsUrl: https://docs.tella.com/
                error: forbidden
                message: You don't have permission to access this resource.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: You don't have permission to access this resource.
          headers:
            Deprecation:
              $ref: '#/components/headers/Deprecation'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            Sunset:
              $ref: '#/components/headers/Sunset'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/XRateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/XRateLimitReset'
        '404':
          content:
            application/json:
              example:
                docsUrl: https://docs.tella.com/
                error: not_found
                message: The requested resource was not found.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: The requested resource was not found.
          headers:
            Deprecation:
              $ref: '#/components/headers/Deprecation'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            Sunset:
              $ref: '#/components/headers/Sunset'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/XRateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/XRateLimitReset'
        '409':
          content:
            application/json:
              example:
                docsUrl: https://docs.tella.com/
                error: conflict
                message: >-
                  The request conflicts with the resource's current state, e.g.
                  an Idempotency-Key whose first request is still in progress.
                  Retry once it settles.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            The request conflicts with the resource's current state, e.g. an
            Idempotency-Key whose first request is still in progress. Retry once
            it settles.
          headers:
            Deprecation:
              $ref: '#/components/headers/Deprecation'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            Sunset:
              $ref: '#/components/headers/Sunset'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/XRateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/XRateLimitReset'
        '429':
          content:
            application/json:
              example:
                docsUrl: https://docs.tella.com/
                error: rate_limited
                message: You have exceeded the rate limit. Please slow down.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: You have exceeded the rate limit. Please slow down.
          headers:
            Deprecation:
              $ref: '#/components/headers/Deprecation'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            Retry-After:
              $ref: '#/components/headers/RetryAfter'
            Sunset:
              $ref: '#/components/headers/Sunset'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/XRateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/XRateLimitReset'
        '500':
          content:
            application/json:
              example:
                docsUrl: https://docs.tella.com/
                error: server_error
                message: An unexpected error occurred
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: An unexpected error occurred
          headers:
            Deprecation:
              $ref: '#/components/headers/Deprecation'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            Sunset:
              $ref: '#/components/headers/Sunset'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/XRateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/XRateLimitReset'
        '501':
          content:
            application/json:
              example:
                docsUrl: https://docs.tella.com/
                error: not_implemented
                message: The requested operation is not implemented.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: The requested operation is not implemented.
          headers:
            Deprecation:
              $ref: '#/components/headers/Deprecation'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            Sunset:
              $ref: '#/components/headers/Sunset'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/XRateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/XRateLimitReset'
        '503':
          content:
            application/json:
              example:
                docsUrl: https://docs.tella.com/
                error: unavailable
                message: >-
                  A dependency was unavailable and the request was not executed.
                  Safe to resend unchanged after the Retry-After delay.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            A dependency was unavailable and the request was not executed. Safe
            to resend unchanged after the Retry-After delay.
          headers:
            Deprecation:
              $ref: '#/components/headers/Deprecation'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            Sunset:
              $ref: '#/components/headers/Sunset'
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/XRateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/XRateLimitReset'
      security:
        - BearerAuth: []
components:
  schemas:
    SaveTextPresetRequest:
      additionalProperties: false
      description: >-
        Save a personal text preset. The style starts from the given text
        overlay, else from the editor's default text look; every style field
        sent alongside overrides it.
      properties:
        background:
          allOf:
            - $ref: '#/components/schemas/TextOverlayBackground'
        backgroundShape:
          allOf:
            - $ref: '#/components/schemas/TextOverlayBackgroundShape'
        color:
          description: >-
            Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase
            #RRGGBBAA.
          example: '#FFFFFFFF'
          pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
          type: string
        fontFamily:
          allOf:
            - $ref: '#/components/schemas/TextOverlayFontFamily'
        fontSizeScale:
          description: >-
            Font size relative to the editor's default (7.5% of the canvas's
            shorter side): 1 is the default, 0.6 a caption, 1.4 a headline.
            Presets are video-independent, so this is a scale rather than
            pixels; adding an overlay resolves it for the video it lands on.
          example: 0.6
          exclusiveMinimum: true
          minimum: 0
          type: number
        fontWeight:
          maximum: 1000
          minimum: 1
          type: number
        fontWidth:
          exclusiveMinimum: true
          minimum: 0
          type: number
        name:
          example: Product callout
          maxLength: 255
          minLength: 1
          type: string
        outline:
          allOf:
            - $ref: '#/components/schemas/TextOverlayOutline'
          description: Outline color, or null for none.
        textAlign:
          allOf:
            - $ref: '#/components/schemas/TextOverlayTextAlign'
        textOverlayId:
          description: >-
            Text overlay to copy the style from, keeping a custom font and
            reading its size relative to that video's canvas. Goes together with
            `videoId`.
          example: ly_abc123
          type: string
        videoId:
          description: >-
            Video holding the text overlay to copy the style from. Goes together
            with `textOverlayId`.
          example: vid_abc123
          type: string
      required:
        - name
      type: object
    TextPreset:
      additionalProperties: false
      properties:
        name:
          example: Label
          type: string
        presetId:
          description: Pass this ID as `presetId` when adding or updating a text overlay
          example: default:label
          type: string
        scope:
          description: >-
            `default` for Tella's built-in styles, `personal` for presets saved
            by the authenticated user
          enum:
            - default
            - personal
          type: string
        style:
          $ref: '#/components/schemas/TextPresetStyle'
      required:
        - presetId
        - name
        - scope
        - style
      type: object
    ErrorResponse:
      additionalProperties: false
      description: Standard error response format
      properties:
        docsUrl:
          description: Link to Tella API documentation
          example: https://docs.tella.com/
          format: uri
          type: string
        error:
          description: Machine-readable error code
          enum:
            - bad_request
            - unauthorized
            - forbidden
            - not_found
            - rate_limited
            - server_error
            - conflict
            - edit_conflict
            - not_implemented
            - unavailable
          example: not_found
          type: string
        message:
          description: Human-readable error message
          example: Resource not found
          type: string
      required:
        - error
        - message
        - docsUrl
      type: object
    TextOverlayBackground:
      description: >-
        Background behind a text overlay, in the same object shape as a clip
        background.
      properties:
        color:
          description: >-
            Hex color string. Required when type = 'solid'. Transparent
            backgrounds use #00000000.
          example: '#5E51F8FF'
          pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
          type: string
        type:
          description: >-
            Background variant. Text overlays take a solid background; the other
            `ClipBackground` variants are not supported behind text.
          enum:
            - solid
          example: solid
          type: string
      required:
        - type
        - color
      type: object
    TextOverlayBackgroundShape:
      description: Shape of the solid background behind the text.
      enum:
        - none
        - regular
        - squircle
      example: squircle
      type: string
    TextOverlayFontFamily:
      description: >-
        One of Tella's catalog font families — the same list the editor's font
        picker offers.
      enum:
        - Inter
        - Roboto Mono
        - Archivo
        - Barlow
        - Caveat
        - DM Sans
        - Figtree
        - Lora
        - Merriweather
        - Montserrat
        - Nunito Sans
        - Open Sans
        - Oswald
        - Playfair Display
        - Poppins
        - Raleway
        - Roboto
        - Roboto Flex
        - Source Sans 3
        - Space Grotesk
      example: Inter
      type: string
    TextOverlayOutline:
      description: >-
        Color of the outline (stroke) drawn around the letters, or null for no
        outline.
      example: '#000000FF'
      nullable: true
      pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
      type: string
    TextOverlayTextAlign:
      description: Horizontal alignment of the text inside its overlay box.
      enum:
        - left
        - center
        - right
      example: center
      type: string
    TextPresetStyle:
      additionalProperties: false
      description: Everything about a text overlay except its text, timing and placement.
      properties:
        background:
          $ref: '#/components/schemas/TextOverlayBackgroundOutput'
        backgroundShape:
          $ref: '#/components/schemas/TextOverlayBackgroundShape'
        color:
          description: >-
            Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase
            #RRGGBBAA.
          example: '#FFFFFFFF'
          pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
          type: string
        fontFamily:
          example: Space Grotesk
          type: string
        fontSizeScale:
          description: >-
            Font size relative to the editor's default (7.5% of the canvas's
            shorter side): 1 is the default, 0.6 a caption, 1.4 a headline.
            Presets are video-independent, so this is a scale rather than
            pixels; adding an overlay resolves it for the video it lands on.
          example: 0.6
          exclusiveMinimum: true
          minimum: 0
          type: number
        fontWeight:
          example: 600
          type: number
        fontWidth:
          example: 100
          type: number
        outline:
          $ref: '#/components/schemas/TextOverlayOutline'
        textAlign:
          $ref: '#/components/schemas/TextOverlayTextAlign'
      required:
        - fontFamily
        - fontWeight
        - fontWidth
        - color
        - fontSizeScale
        - textAlign
        - background
        - backgroundShape
        - outline
      type: object
    TextOverlayBackgroundOutput:
      additionalProperties: false
      description: >-
        Background behind a text overlay, in the same object shape as a clip
        background.
      properties:
        color:
          description: >-
            Hex color string. Required when type = 'solid'. Transparent
            backgrounds use #00000000.
          example: '#5E51F8FF'
          pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
          type: string
        type:
          description: >-
            Background variant. Text overlays take a solid background; the other
            `ClipBackground` variants are not supported behind text.
          enum:
            - solid
          example: solid
          type: string
      required:
        - type
        - color
      type: object
  headers:
    Deprecation:
      description: Indicates that an API operation is deprecated, following RFC 9745
      example: '@1767225600'
      schema:
        type: string
    RateLimit:
      description: >-
        Current quota with remaining requests (`r`) and seconds until reset
        (`t`)
      example: '"public-api";r=95;t=42'
      schema:
        type: string
    RateLimitPolicy:
      description: >-
        Named quota policy with the request limit (`q`) and window in seconds
        (`w`)
      example: '"public-api";q=100;w=60'
      schema:
        type: string
    Sunset:
      description: >-
        Indicates when a deprecated API operation will become unavailable,
        following RFC 8594
      example: Tue, 30 Jun 2026 23:59:59 GMT
      schema:
        type: string
    XRateLimitLimit:
      description: Maximum requests allowed in the current window
      example: 100
      schema:
        type: integer
    XRateLimitRemaining:
      description: Requests remaining in the current window
      example: 95
      schema:
        type: integer
    XRateLimitReset:
      description: Unix timestamp in milliseconds when the window resets
      example: 1704067200000
      schema:
        format: int64
        type: integer
    RetryAfter:
      description: Seconds to wait before retrying a rate-limited request
      example: 45
      schema:
        minimum: 1
        type: integer
  securitySchemes:
    BearerAuth:
      description: API key obtained from your Tella account settings
      scheme: bearer
      type: http

````

## Related topics

- [Text overlays](/docs/mcp-tools/text-overlays.md)
- [Product Changelog](/docs/changelog.md)
- [Save a subtitle preset](/docs/api-reference/videos/save-a-subtitle-preset.md)
- [Add text to your video](/docs/help/editing/text-overlays.md)
- [List text presets](/docs/api-reference/clips/list-text-presets.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.