Playbooks

List a case's executions

Returns every run of the case's nodes, newest first.

get/v1/projects/{project_id}/playbook-cases/{case_id}/executions

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/playbook-cases/{case_id}/executions
  • 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

case_idstring required
Example:pbk_case_V1StGXR8Z5jdHi6B

The case ID

Query parameters

node_idstring
Example:revenue

Only the executions of this node

limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

offsetinteger

Results to skip. Negative or not an integer it is 400.

Response

List of executions, newest first

totalinteger required
limitinteger required
offsetinteger required

Example response

{
  "data": [
    {
      "id": "pbk_exe_V1StGXR8Z5jdHi6B",
      "case_id": "pbk_case_V1StGXR8Z5jdHi6B",
      "node_id": "revenue",
      "executor": {
        "id": "agent_V1StGXR8Z5jdHi6B"
      },
      "error": {
        "code": "AI_PROVIDER_ERROR",
        "message": "Provider returned 402: insufficient credits"
      },
      "created_by_principal_type": "user",
      "created_by_principal_id": "user_V1StGXR8Z5jdHi6B",
      "on_behalf_of": {
        "tool_id": "tool_V1StGXR8Z5jdHi6B",
        "agent_id": "agent_V1StGXR8Z5jdHi6B",
        "generation_id": "gen_V1StGXR8Z5jdHi6B",
        "session_id": "sess_V1StGXR8Z5jdHi6B",
        "actor_id": "actor_V1StGXR8Z5jdHi6B"
      }
    }
  ]
}

Changes

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