Playbooks

Get a playbook

Returns a playbook with its current definition and version.

get/v1/projects/{project_id}/playbooks/{playbook_id}

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/playbooks/{playbook_id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Path parameters

playbook_idstring required
Example:pbk_V1StGXR8Z5jdHi6B

The playbook ID

Response

The playbook

idstring
project_idstring
namestring
descriptionstring nullable
versioninteger

The definition's version. Bumped only by a write that changes definition.

created_atstring date-time
updated_atstring date-time

Example response

{
  "id": "pbk_V1StGXR8Z5jdHi6B",
  "project_id": "proj_V1StGXR8Z5jdHi6B",
  "name": "client-pricing",
  "version": 1,
  "definition": {
    "nodes": [
      {
        "id": "regime",
        "title": "Tax regime",
        "inputs": [
          {
            "name": "revenue",
            "schema": {
              "type": "number"
            },
            "source": {
              "node_id": "revenue",
              "field": "output.annual_revenue"
            }
          }
        ],
        "executor": {
          "id": "dcd_V1StGXR8Z5jdHi6B"
        },
        "transformations": [
          {
            "name": "proposal",
            "format": "pdf",
            "tool": "tool_V1StGXR8Z5jdHi6B"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.