List Operator Threads

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

The conversations held with this graph's AI operators, most recently active first: every run made under a thread_id grouped by it, with the first question as the title. A graph admin sees every user's threads; any other member sees their own. Open a thread's runs at /audit/runs.

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

user_idoptional string Only this user's threads (admins; members see their own)

cursoroptional string The `next_cursor` of the previous page

Name	Type	Description
`user_id`optional	string	Only this user's threads (admins; members see their own)
`cursor`optional	string	The `next_cursor` of the previous page
`limit`optional	integer	Threads per page Default: `50` Constraints: 1–200

limitoptional

integer

Threads per page

Default: 50

Constraints: 1–200

Example request

curl

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

Responses

200 Successful Response

Field Type Description

graph_idrequired string

threadsrequired

OperatorThreadSummary[]

One console conversation: the runs that share a thread id.

OperatorThreadSummary fields

Field	Type	Description
`thread_id`required	string	The thread id the runs were made under
`user_id`required	string	The user whose conversation it is
`title`required	string	The conversation's first question, clipped
`run_count`required	integer	Runs in the thread
`first_run_at`required	string (date-time)	When the first run started
`last_run_at`required	string (date-time)	When the latest run started
`last_operator_type`required	string	The operator the latest run used
`last_status`required	string	How the latest run ended One of: `completed`, `failed`, `cancelled`

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