List conversation messages

Retrieve the full message history for a specific conversation session, ordered chronologically from oldest to newest.

GET/conversations/{{conversationId}}/messages

Request parameters

Path

conversationIdstringrequired

The unique UUID of the conversation session.

Headers

Authorizationstringrequired

Your API Key formatted as Bearer sk_live_…

Response

dataarray

An ordered list of message objects in the conversation.

idstring

The unique UUID of the message.

rolestring

The sender of the message: user or assistant.

contentstring

The text content of the message.

metadataobject

Additional metadata associated with the message.

created_atstring

The ISO 8601 timestamp of when the message was sent.

cURL

curl -X GET https://app.picobot.dev/api/conversations/b7cd5a46-9878-479e-903c-03bc2a7d09a8/messages \
  -H "Authorization: Bearer <token>"

Node.js

fetch('https://app.picobot.dev/api/conversations/b7cd5a46-9878-479e-903c-03bc2a7d09a8/messages', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <token>'
  }
})
.then(res => res.json())
.then(console.log);

Python

import requests

headers = { "Authorization": "Bearer <token>" }
response = requests.get(
  "https://app.picobot.dev/api/conversations/b7cd5a46-9878-479e-903c-03bc2a7d09a8/messages",
  headers=headers
)
print(response.json())

{
  "data": [
    {
      "id": "a1b2c3d4-0000-0000-0000-000000000001",
      "role": "user",
      "content": "Hello, I need help with my order.",
      "metadata": {},
      "created_at": "2024-06-14T15:45:34+00:00"
    },
    {
      "id": "a1b2c3d4-0000-0000-0000-000000000002",
      "role": "assistant",
      "content": "Hi! I'd be happy to help. Could you share your order number?",
      "metadata": {},
      "created_at": "2024-06-14T15:45:36+00:00"
    }
  ]
}