Tools

apply_editor_proposal

Apply a proposal from ask_editor_agent (edit.status "proposed"). Only after the user has seen edit.summaries and said yes.

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

proposalId string required

View schema

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

digest string required

View schema

{
  "type": "string",
  "pattern": "^[a-f0-9]{64}$"
}

confirm boolean required

Must be true, and only after the user has approved exactly what you show them.

View schema

{
  "description": "Must be true, and only after the user has approved exactly what you show them.",
  "type": "boolean",
  "const": true
}

Request example

{
  "name": "apply_editor_proposal",
  "arguments": {
    "projectId": "00000000-0000-4000-8000-000000000001",
    "proposalId": "YOUR_PROPOSAL_ID",
    "digest": "0000000000000000000000000000000000000000000000000000000000000000",
    "confirm": true
  }
}

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.