Tools

index_footage

Queue indexing for footage already in the library. Omit confirm to read the Clips-minute estimate. Set confirm to true only after the user accepts it. A file already indexed at this version is returned without a second hold.

Access token · edit · Changes account data

Parameters

asset_ids array required

View schema

{
  "minItems": 1,
  "maxItems": 20,
  "type": "array",
  "items": {
    "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)$"
  }
}

confirm boolean optional

True only after the user has accepted the estimate.

View schema

{
  "description": "True only after the user has accepted the estimate.",
  "type": "boolean"
}

Request example

{
  "name": "index_footage",
  "arguments": {
    "asset_ids": [
      "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.