Retrieve the latest Event node for each event_id in a Run, together with structural parent edges and causal links.
cURL
curl "https://eu.whitecircle.com/api/runs/run_main/graph?environment_id=environment_123&limit=100" \
-H "Authorization: Bearer wc-your-api-key" \
-H "whitecircle-version: 2026-06-01"The API key determines the workspace. Pass environment_id on every request. Runs with the same run_id in other Environments are never included.
JSON
{
"nodes": [
{
"type": "message",
"content_field": "content",
"status": "completed",
"run_id": "run_main",
"event_id": "final_answer",
"internal_event_id": "019...",
"environment_id": "environment_1"
},
{
"type": "tool",
"content_field": "output",
"status": "completed",
"run_id": "run_security",
"event_id": "security_output",
"internal_event_id": "019...",
"environment_id": "environment_1"
}
],
"edges": [
{
"kind": "link",
"source": { "run_id": "run_main", "event_id": "final_answer" },
"target": { "run_id": "run_security", "event_id": "security_output" }
}
],
"next_cursor": null,
"has_more": false
}Edges and unresolved targets
Every edge connects a source Event to a target Event.
parentconnects an Event to its single structural parent. Run trees and breadcrumbs use only parent edges.linkrecords a causal input and may point to another run in the same Environment.
The response includes every edge target in nodes, including targets outside the requested page or in another Run in the same Environment. If the target Event has not been stored yet, its node contains the requested public IDs and internal_event_id: null. This preserves the reference without pretending the target exists.
Pagination
limit defaults to 100. The API rejects 0 and clamps any value above 100 to 100. Pass next_cursor as after to load the next page. A cursor is valid only for the Environment and Run that produced it; using it with another scope returns 400.
The graph returns the latest attempt for each public event_id, regardless of whether it completed or failed. A retry created while you paginate moves that Event to its new latest-attempt position, which may be before your current cursor. Restart pagination when you need a fresh complete latest-attempt view; cursors do not snapshot a changing Run.
Use the returned internal_event_id with the Get Event endpoint to retrieve moderation details.
Authorizations
Headers
Path Parameters
Query Parameters
Response
Run graph retrieved
One page of a run graph: the latest attempt of each Event plus parent and link edges.
nodesobject[]requiredEvents in this page, plus every edge target, including targets in other runs or not stored yet.
Show child attributesHide child attributes
nodes.run_id stringrequiredRun of the Event.
nodes.event_id stringrequiredYour ID for the Event.
nodes.environment_id stringrequiredEnvironment of the Event.
nodes.type stringrequiredKind of Event, or
unknownfor a target that has not been stored yet.nodes.internal_event_id string | nullWhite Circle's ID for the latest attempt.
nullwhen the Event has not been stored yet.nodes.name string | nullTool, function, agent, or artifact name sent with the Event.
nodes.content_field null | enum<string>Content field the Event was checked on.
Available options:
content,delta,arguments,output,definition,input,instructions,statenodes.call_id string | nullTool or function invocation ID sent with the Event.
nodes.stream_id string | nullStream ID sent with the Event.
nodes.sequence integer<int64> | nullStream position sent with the Event.
nodes.role string | nullRole the Event was checked with.
nodes.status string | nullOutcome of the latest attempt.
nodes.violation boolean | nullWhether the initial check flagged the Event.
nodes.effective_violation boolean | nullFinal verdict after White Circle's secondary review. Prefer it over
violation.nodes.not_sure boolean | nulltruewhen the check could not reach a confident verdict.nodes.created_at string | nullWhen the latest attempt was saved. ISO 8601 timestamp.
nodes.updated_at string | nullWhen the latest attempt last changed. ISO 8601 timestamp.
nodes.external_session_id string | nullSession the Event belongs to.
edgesobject[]requiredParent and link relationships declared by Events in this page.
Show child attributesHide child attributes
has_morebooleanrequiredtrueif more Events remain after this page.next_cursorstring | nullPass as
afterto load the next page.nullon the last page.
Invalid run or cursor
Internal server error