List Operator Runs

get/v1/graphs/{graph_id}/audit/runs

The in-app AI operator runs made on this graph, newest first: each run's question, answer, outcome, cost and the tools it called. This is the record behind a mutation audit entry's operation_id, kept after the operation itself has expired. A graph admin sees every user's runs; any other member sees their own. Filter by thread_id for one conversation.

Authentication

Authenticate in any one of these ways — not all of them:

API key in the X-API-Key header.
Bearer token in the Authorization header.

Path parameters

Name	Type	Description
`graph_id`required	string	Graph identifier Constraints: matches `^(kg[a-f0-9]{16,}(?:_[a-zA-Z0-9]{1,20})?\|sec(?:_[a-zA-Z0-9]{1,20})?\|library)$`

Query parameters

Name	Type	Description
`thread_id`optional	string	Only the runs of this thread
`user_id`optional	string	Only runs made as this user (admins; members see their own)
`operator_type`optional	string	Only runs of this operator
`status`optional	string	Only runs that ended this way One of: `completed`, `failed`, `cancelled`
`since`optional	string (date-time)	Only runs started at or after this time
`until`optional	string (date-time)	Only runs started before this time
`cursor`optional	string	The `next_cursor` of the previous page
`limit`optional	integer	Runs per page Default: `50` Constraints: 1–200

Example request

curl

curl -X GET "https://api.robosystems.ai/v1/graphs/{graph_id}/audit/runs" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY"

Responses

200 Successful Response

Field Type Description

graph_idrequired string

runsrequired

OperatorRunSummary[]

One in-app AI operator run: what it was asked and what it answered.

OperatorRunSummary fields

Field	Type	Description
`operation_id`required	string	The run's operation id; every mutation audit entry the run made carries it as `operation_id`
`thread_id`optional	string	The conversation the run belongs to, when the caller threaded it; null for a standalone API call
`user_id`required	string	The user the run ran as
`operator_type`required	string	The operator that ran
`mode`required	string	The execution mode the run used
`status`required	string	How the run ended One of: `completed`, `failed`, `cancelled`
`question`required	string	The message the run was given
`answer`optional	string	The operator's answer; null when the run did not reach one
`error`optional	string	Why a failed run failed
`credits_consumed`optional	number	Credits the run's model calls cost Default: `0`
`call_count`optional	integer	Model calls the run made Default: `0`
`tools_called`optional	string[]	The tools the run called, each named once
`write_count`optional	integer	Writes the run made to the graph Default: `0`
`started_at`required	string (date-time)	When the run started on the worker
`finished_at`required	string (date-time)	When the run ended
`duration_ms`required	number	How long the run took

next_cursoroptional

string

Pass as cursor for the next, older page; null on the last page

Status	Meaning
400	Invalid request
401	Authentication required
403	Access denied
404	Resource not found
422	Validation Error
429	Rate limit exceeded
500	Internal server error