sdkDeterministic

Apply table playbook

pipeline.applyTablePlaybook

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

TypeScripttypescript

await pipeline.applyTablePlaybook({
  "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"
  ]
}

Exceptions

PipelineError: Thrown for validation, authentication, JSON-RPC, HTTP, and network failures. Inspect code and data when present.