Skip to main content
GET
/
v2
/
runs
/
{run_id}
/
messages
List Run Messages
curl --request GET \
  --url https://api.duvo.ai/v2/runs/{run_id}/messages \
  --header 'Authorization: Bearer <token>'
{
  "messages": [
    {
      "id": "<string>",
      "type": "<string>",
      "role": "<string>",
      "timestamp": "<string>",
      "text_content": "<string>",
      "tool_call": {
        "id": "<string>",
        "name": "<string>",
        "arguments": {}
      },
      "tool_result": {
        "tool_call_id": "<string>",
        "result": "<unknown>",
        "error": "<string>"
      }
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

Authorizations

​
Authorization
string
header
required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

​
run_id
string<uuid>
required

The run's unique identifier

Query Parameters

​
limit
integer
default:20

Number of messages per page (1-50, default 20)

Required range: 1 <= x <= 50
​
offset
integer

Number of messages to skip

Required range: 0 <= x <= 9007199254740991

Response

Default Response

​
messages
object[]
required

Messages for the run, in chronological order

​
total
number
required

Total number of messages for the run

​
limit
number
required

Number of messages per page

​
offset
number
required

Number of messages skipped