Read a task's messages

The messages on a task, oldest first, one page at a time. This is how you read the reply after a trigger: poll until an assistant message appears.

Request

curl "https://api.dhanu.ai/api/pub/v1/tasks/$TASK_ID/messages?limit=50" \
  -H "Authorization: Bearer $DHANU_API_KEY"

// One page
const page = await dhanu.tasks.messagesPage(taskId, { limit: 50 });
const next = await dhanu.tasks.messagesPage(taskId, { cursor: page.nextCursor });

// Or everything, following pages to the end
const all = await dhanu.tasks.messages(taskId);

# One page
page = dhanu.tasks.messages_page(task_id, limit=50)
next_page = dhanu.tasks.messages_page(task_id, cursor=page.next_cursor)

# Or everything, following pages to the end
rows = dhanu.tasks.messages(task_id)

Response

200 OK

{
  "data": [
    { "id": "…", "role": "user", "text": "Draft minutes for today's stand-up.", "createdAt": "…" },
    { "id": "…", "role": "assistant", "text": "Here are the minutes…", "createdAt": "…" }
  ],
  "nextCursor": null,
  "hasMore": false,
  "messages": [ … ]
}

Pass nextCursor back as cursor to fetch the next page; when hasMore is false you hold the last one. messages mirrors data for clients written before pagination and is deprecated, see Versioning.

Errors

The full list is on Errors.