Get Trace
Not available yet. This operation is part of the published contract and answers
501 not_implementeduntil it is built. The request and response shapes below are final for this contract version.
Span content only where the client's trace content policy allows it.
HTTPBearerAuthorizationBearer <token>Bearer credential. API keys look like sqk_<geo>_<key_id>_<secret>: treat them as opaque and never put one in a browser. Older keys without the geo part stay valid until rotated. Find a geo's endpoints through GET /.well-known/sparq-discovery before sending a key.
run_id*Run IduuidSparq-Workspace?stringFor a person signed in to a console with several workspaces: the workspace this call is for, one of their memberships (listMyMemberships). Without it such a person gets workspace_required (400); a workspace they are not a member of is forbidden. It never grants anything, and other callers' credentials ignore it.
uuidSuccessful Response
application/json- response
run*spans*array<>curl -X GET 'http://dev-sparq.centralindia.cloudapp.azure.com:8000/v1/admin/traces/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "run": { "run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec", "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82", "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9", "audience_tenant_id": "0287c3f7-886a-49f4-a73e-03577e798c26", "agent": { "name": "string", "version": "1.4.0" }, "status": "queued", "started_at": "2019-08-24T14:15:22Z", "ended_at": "2019-08-24T14:15:22Z", "usage": { "input_tokens": 0, "output_tokens": 0, "cached_tokens": 0, "reasoning_tokens": 0, "estimated_cost_usd": "string", "credential_id": "13c40afa-2996-4a0c-b2e9-68fba9462242" }, "credential_id": "13c40afa-2996-4a0c-b2e9-68fba9462242", "spans": 0 }, "spans": [ { "span_id": "string", "parent_span_id": "string", "kind": "model", "name": "string", "started_at": "2019-08-24T14:15:22Z", "duration_ms": 0, "status": "ok", "cost_usd": "string", "credential_id": "13c40afa-2996-4a0c-b2e9-68fba9462242", "attributes": { "property1": "string", "property2": "string" }, "content": { "policy": "off", "input": "string", "output": "string" } } ]}Get Run Envelope GET
> **Not available yet.** This operation is part of the published contract and answers `501 not_implemented` until it is built. The request and response shapes below are final for this contract version. The context envelope a run used, to explain why a feature or tool was on or off.
List Audit GET
Audit records, oldest first. With `project_id`, that project's records; otherwise the caller's own workspace. `cursor` continues from the previous page.