mcpDeterministic

Apply table playbook

tools/call

Apply one implemented playbook as a typed parent and child column family. Validates mappings and workspace BYOK but never executes rows.

Parameters

workspaceId

string

Optional with API key auth, inferred from the key.

tableIdrequired

string

No description.

playbookIdrequired

string

Playbook ID returned by list-table-playbooks

pricing-plans | new-in-role

inputMappingsrequired

object

Playbook input key to existing Table column ID.

executionModerequired

string

No description.

pipeline_hosted | external_agent

llmCredentialId

string

No description.

searchCredentialId

string

No description.

providerCredentialId

string

No description.

allowDuplicate

boolean

No description.

allowHostedAi

boolean

Required for API, MCP, CLI, and SDK callers that explicitly choose pipeline_hosted execution.

Example

MCP tools/calljson

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "apply-table-playbook",
    "arguments": {
      "tableId": "00000000-0000-4000-8000-000000000000",
      "playbookId": "pricing-plans",
      "inputMappings": {},
      "executionMode": "pipeline_hosted"
    }
  }
}

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "playbookId": {
      "type": "string"
    },
    "executionMode": {
      "type": "string"
    },
    "parentColumnId": {
      "type": "string"
    },
    "childColumnIds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "addedColumnIds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "resolvedInputMappings": {
      "type": "object"
    }
  },
  "required": [
    "playbookId",
    "executionMode",
    "parentColumnId",
    "childColumnIds",
    "addedColumnIds",
    "resolvedInputMappings"
  ]
}

JSON-RPC errors

-32602: Invalid parameters. Field-level details are returned in the JSON-RPC error data.
-32001: Authentication or hosted AI consent is required.
-32003: Workspace access is denied.
-32029: The request was rate limited.