Tools

edit_timeline

Apply 1 to 32 edit commands (see list_edit_commands) to a project's timeline in one step; all of them apply or none do. baseRevision is the revisionId you last read from get_timeline. If the timeline changed meanwhile, non-overlapping edits still apply, otherwise you get a conflict and should read it again. Edits are undoable in the Heavenly editor.

Access token · edit · Changes account data

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)$"
}

baseRevision string required

View schema

{
  "type": "string",
  "minLength": 1,
  "maxLength": 128
}

commands array required

View schema

{
  "minItems": 1,
  "maxItems": 32,
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "additionalProperties": {}
  }
}

Request example

{
  "name": "edit_timeline",
  "arguments": {
    "projectId": "00000000-0000-4000-8000-000000000001",
    "baseRevision": "YOUR_BASE_REVISION",
    "commands": [
      {
        "type": "YOUR_TYPE"
      }
    ]
  }
}

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.