API reference

List a task's messages

Returns messages in chronological order. Use nextCursor to continue from the last message in the page.

GET/v1/tasks/{taskId}/messages

Authorization

Send a personal API key or an OAuth access token as Authorization: Bearer <token>.

OAuth scopes: tasks:read

Parameters

cursorstring, query
Opaque cursor returned by the previous page
limitinteger, query
taskIdstring (uuid), pathrequired

Responses

200Success

messagesobject[]required
idstringrequired
role"user" | "assistant"required
partsobject[]required
createdAtstring (date-time)required
nextCursorstring | nullrequired

400Invalid request

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

401Missing or invalid Bearer credential

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

402Payment or subscription required

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

403Credential is missing a required scope

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

404Resource not found

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

409Request conflict

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

429Rate limit exceeded

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

500Internal API error

errorobjectrequired
typestringrequired
messagestringrequired
requestIdstring

curl --request GET \
  --url 'https://api.staging.adam.new/v1/tasks/{taskId}/messages' \
  --header 'Authorization: Bearer <token>'

{
  "messages": [
    {
      "id": "<string>",
      "role": "user",
      "parts": [
        {
          "type": "reasoning",
          "text": "<string>"
        }
      ],
      "createdAt": "2026-01-01T00:00:00.000Z"
    }
  ],
  "nextCursor": "<string>"
}