List traces | Astro AI | Documentation

Returns a paginated list of traces for the agent.

AuthorizationBearer

OAuth 2.0 device flow or session token from WorkOS

accountstringRequired

Account name (slug)

namestringRequired

Agent name

start_timedatetimeOptional

Start of time range (RFC 3339)

end_timedatetimeOptional

End of time range (RFC 3339)

limitintegerOptionalDefaults to 50

Maximum number of traces to return (default 50)

offsetintegerOptionalDefaults to 0

Pagination offset (default 0)

statusenumOptional

Filter by status (ok or error)

Allowed values:

Paginated list of traces

traceslist of objects or null

totalinteger or null

limitinteger or null

offsetinteger or null

1	{
2	"traces": [
3	{
4	"trace_id": "a3f5c9d2-7b4e-4f1a-9c3d-2e8b7f6a1d4c",
5	"name": "UserLoginFlow",
6	"status": "ok",
7	"latency_ms": 245.7,
8	"input": "{\"username\":\"jdoe@example.com\",\"password\":\"[REDACTED]\"}",
9	"output": "{\"result\":\"success\",\"userId\":\"12345\"}",
10	"timestamp": "2024-04-20T14:22:35Z"
11	}
12	],
13	"total": 1,
14	"limit": 1,
15	"offset": 0
16	}

1	curl https://api.astropod.ai/api/v1/agents/account/name/observability/traces \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json"