List traces | Astro AI | Documentation

Returns a paginated list of traces for the agent.

AuthorizationBearer

OAuth 2.0 device flow or platform session token

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

totalinteger

limitinteger

offsetinteger

401

Unauthorized Error

403

Forbidden Error

503

Service Unavailable Error

1	{
2	"traces": [
3	{
4	"trace_id": "4f8b3a2e-9c7d-4a1f-bb2e-3d5f7a9c8e12",
5	"name": "UserLogin",
6	"status": "ok",
7	"latency_ms": 123.45,
8	"input": "{\"username\":\"jdoe\",\"password\":\"********\"}",
9	"output": "{\"result\":\"success\",\"userId\":\"u12345\"}",
10	"timestamp": "2024-01-15T09:30:00Z"
11	}
12	],
13	"total": 1,
14	"limit": 1,
15	"offset": 1
16	}

$	curl https://astropods.com/api/v1/agents/account/name/observability/traces \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"