Agent messages API

Read authorized conversation records. Keep responses containing private code or conversations out of published examples.

Use API authentication for protected requests. Examples use your own resource IDs and a temporary token; saved response examples are synthetic.

Method	Path	Operation
`GET`	`/v1/agent_message`	List agent messages
`GET`	`/v1/agent_message/{id}`	Get agent message

List agent messages

GET /v1/agent_message

Returns a paginated list of AgentMessage

Authentication: bearer token and the team header shown below.

Parameters

Name	Location	Required	Description
`X-Tenant-ID`	header	yes	Active team ID. Must match the tenant bound to a diagnostic token.
`page`	query	no	Page number
`per_page`	query	no	Items per page

Request example

Set ADIOS_API_URL=https://api.adios.dev. For protected requests, set ADIOS_ACCESS_TOKEN and ADIOS_TEAM_ID as in the quickstart. Set any additional ADIOS_* variables from your own resource results.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/agent_message" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Response: HTTP 200

List of AgentMessage

Response fields

Field	Type	Description
`data`	array
`data[].agent_message_id`	string
`data[].agent_session_id`	string
`data[].content`	object
`data[].content_json`	object
`data[].created_at`	integer	(Unix timestamp)
`data[].deleted_at`	integer	(Unix timestamp)
`data[].metadata`	object
`data[].role`	string	Allowed: system, user, assistant, tool.
`data[].sequence`	integer
`data[].team_id`	string
`data[].token_count`	integer
`data[].tool_call_id`	object
`data[].tool_name`	string
`data[].updated_at`	integer	(Unix timestamp)
`pagination`	object
`pagination.page`	integer	Current page number
`pagination.per_page`	integer	Number of items per page
`pagination.total`	integer	Total number of items

Illustrative example; not a live response:

{
  "data": [
    {
      "agent_message_id": "000000000000000000000000001",
      "agent_session_id": "000000000000000000000000001",
      "content": "",
      "content_json": {},
      "created_at": 1791072000,
      "deleted_at": 0,
      "metadata": {},
      "role": "system",
      "sequence": 0,
      "team_id": "000000000000000000000000001",
      "token_count": 0,
      "tool_call_id": "",
      "tool_name": "",
      "updated_at": 1791072000
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 1
  }
}

Get agent message

GET /v1/agent_message/{id}

Returns a single AgentMessage

Set agent_message_id using IDs from your own API responses.