Retrieve a run's conversation log
/api/v1/runs/{run_id}/conversationGet the conversation log for a completed run.
Returns the full conversation state including compacted content. Only available for completed runs that have a persisted conversation log.
Required access
Credentials: service principal, delegated token, user session
Scope: runs:read
An organization-owned automation key, prefixed gsmc_sk_. Already bound to one organization, so it needs no X-Org-Id header. It carries no user identity: it never reaches a private resource however it is scoped, and a run it starts has no user for an interactive tool to reach.
In: header
Path Parameters
Header Parameters
Selects the active organization for a credential that belongs to more than one. Service-principal keys are bound to a single organization and ignore it.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/runs/0/conversation" \ -H "Authorization: Bearer $GUEST_MACHINES_API_KEY"{ "entries": [ { "role": "user", "content": "string", "activity": { "kind": "domain_tool", "domain_tool": { "origin": "builtin", "source_id": "string", "canonical_name": "string", "display_name": "string", "enabled": true, "owned_by_caller": true }, "title": "string", "summary": "string" }, "timestamp": "2019-08-24T14:15:22Z" } ], "run_id": 0}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}Stream run events GET
Server-Sent Events stream for real-time run execution events. Connection stays open until the run reaches a terminal state (completed, failed, cancelled) or the client disconnects. Supports reconnection via the Last-Event-ID header.
Cancel a run POST
Stop a pending or running execution.