List stored agent-run trace sessions

GET

/v1/agent-traces

curl --request GET \
  --url 'https://api.aerandil.com/v1/agent-traces?limit=50' \
  --header 'Authorization: Bearer <token>'

• Production API

Newest-activity-first session summaries, optionally filtered to one agent. Requires traces:read.

Authorizations

• aerandil_oauth

Parameters

Query Parameters

agent_name

string

limit

integer

default: 50 >= 1 <= 200

Responses

200

Session summaries

Media typeapplication/json

object

data

Array<object>

object

agent_name

string

last_at

string format: date-time

last_event

string

session_id

string

span_count

integer

started_at

string format: date-time

Example^generated

{
  "data": [
    {
      "agent_name": "example",
      "last_at": "2026-04-15T12:00:00Z",
      "last_event": "example",
      "session_id": "example",
      "span_count": 1,
      "started_at": "2026-04-15T12:00:00Z"
    }
  ]
}