Skip to content
Sign InDashboard
Tools

get_footage_index

Connect in ChatGPT

The transcript, segments, tags, beats, and people for one of the user's files. include can be transcript, segments, tags, beats, or people. Beats are the native tracker's times. People are speakers, person rows, and faces already found for the file. The same label on two files is one person.

Access token · read · Read only

Parameters

asset_id string required
View schema
asset_id schema
{
  "type": "string",
  "format": "uuid",
  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
}
include array optional

transcript, segments, tags, beats (native tracker times), or people (speakers, person rows, faces).

View schema
include schema
{
  "description": "transcript, segments, tags, beats (native tracker times), or people (speakers, person rows, faces).",
  "type": "array",
  "items": {
    "type": "string",
    "enum": [
      "transcript",
      "segments",
      "tags",
      "beats",
      "people"
    ]
  }
}

Request example

Tool request · example
{
  "name": "get_footage_index",
  "arguments": {
    "asset_id": "00000000-0000-4000-8000-000000000001"
  }
}

Replace example values with ids and arguments read from your own Heavenly account. This example does not execute a tool.

Returns

The tool result from Heavenly’s workspace, encoded as MCP text content. The connector returns isError when an argument, permission, plan or account check fails.

Account access and permissions are checked by Heavenly. See errors for failure handling.