Skip to main content
GET
/
runs
/
{run_id}
/
messages
List run messages
curl --request GET \
  --url https://api.duvo.ai/v1/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
}

Documentation Index

Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

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