Sign in
Backgrounds

List available backgrounds

Returns personal uploads, workspace uploads, and Tella's default image and animated backgrounds in named categories. Each item includes a preview URL and a background value that can be passed directly to the clip update endpoint.

get/v1/backgrounds

Query parameters

scope'personal' | 'workspace' | 'default'

Where the background comes from: the authenticated user's uploads, workspace uploads, or Tella's default catalog

Filter by scope

categoryIdstring

Filter by category ID, such as personal, workspace, default:tella, default:macos, or default:animated

Filter by category ID, such as personal, workspace, default:tella, default:macos, or default:animated

Response

OK

Example response

{
  "categories": [
    {
      "backgrounds": [
        {
          "background": {
            "color": "#000000ff",
            "gradientAngle": 45,
            "gradientColor1": "#ff0080ff",
            "gradientColor2": "#7928caff",
            "sourceId": "su_abc123",
            "type": "solid",
            "videoDurationSeconds": 12.4
          },
          "name": "Red Horizon"
        }
      ],
      "id": "default:tella",
      "name": "Tella"
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.