List execution steps

curl --request GET \
  --url https://api.neoagent.io/public-api/executions/{execution_id}/steps \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "data": null,
      "is_error": true,
      "message": "<string>",
      "step_id": "<string>",
      "tool_call_id": "<string>",
      "tool_type_name": "<string>"
    }
  ],
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timings_ms": {},
    "pagination": {
      "has_more": true,
      "next_cursor": "<string>"
    },
    "warnings": [
      "<string>"
    ]
  }
}

Executions

List execution steps

The ordered steps (tool calls, messages, errors) recorded for a run — the forensic trace of what the agent actually saw and did. The path id accepts either an AGENTIC / CHAINED_ACTIONS execution (run) id or a CONVERSATIONAL chat session id; both resolve their trace here. AGENTIC / CONVERSATIONAL traces can be large; use the filters to fetch only what you need (e.g. the agent’s baseline ticket read) rather than pulling every step. type and tool_type_name narrow by step kind and tool; include_data=false returns a lightweight index (no per-step I/O) to locate a step, then re-fetch just it by step_id.

GET

public-api

executions

{execution_id}

steps

List execution steps

curl --request GET \
  --url https://api.neoagent.io/public-api/executions/{execution_id}/steps \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "data": null,
      "is_error": true,
      "message": "<string>",
      "step_id": "<string>",
      "tool_call_id": "<string>",
      "tool_type_name": "<string>"
    }
  ],
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timings_ms": {},
    "pagination": {
      "has_more": true,
      "next_cursor": "<string>"
    },
    "warnings": [
      "<string>"
    ]
  }
}

Authorizations

Authorization

string

header

required

Authorization: Bearer <token> where <token> is either a neo_sk_<env>_<secret> API key (service account) or a Microsoft Entra ID access token (dashboard user).

Path Parameters

execution_id

string

required

Query Parameters

type

string

Comma-separated StepType values to include (e.g. TOOL_CALL,TOOL_RESULT,THOUGHT,FINAL_MESSAGE).

tool_type_name

string

Only steps for this tool (e.g. CW_PSA_REQUEST, GET_TECHNICIAN_CONTEXT). Case-insensitive.

step_id

string

Return only the single step with this id (with its full data).

include_data

boolean

Set false to omit each step's data (tool inputs/outputs, reasoning) and return a lightweight index. Default true.

Response

Success.

data

ExecutionStep · object[]

required

Show child attributes