AGagentsky
traces

The trace bundle [read]

Changed on

Spans, the sessions and tasks they reach, cost counted once per session, and gaps. A session joins by an event naming it or by its own metadata.trace_id. Returns 404 when the TASK_TRACES switch is off for the workspace and 503 not_migrated before the tables exist.

get/traces/{id}

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/traces/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

The trace id (trc_…)

Response

OK

coverage'metadata_only' | 'partial' | 'redacted' required

metadata_only when no event carries content; redacted when any kept content had a value replaced or was dropped

spansobject[] required

What sources reported, oldest first. edge is root, resolved, pending (its parent may still arrive) or unresolved (the parent never arrived within 10 minutes). A span its source left open that names a session ends with that session's turn (outcome_source: platform): failed on session.error, completed on session.status_idle, cancelled when the session was archived or deleted first. Events with content carry content.text, up to 4 MiB per bundle.

sessionsobject[] required

Platform sessions the trace reaches, with their tasks' members; each listed once

task_idsstring[] required
gapsobject[] required

Changes