Tools

get_timeline

The project's timeline: sequence, tracks, files and clips (first 100 clips; page for more), and the current revisionId. Read this before edit_timeline and pass its revisionId back.

Access token · read · Read only

Parameters

projectId string required

The project's id (from list_projects).

View schema

{
  "description": "The project's id (from list_projects).",
  "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)$"
}

page integer optional

View schema

{
  "type": "integer",
  "minimum": 1,
  "maximum": 500
}

Request example

{
  "name": "get_timeline",
  "arguments": {
    "projectId": "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.