List conversations

Retrieve a list of all active or completed chat sessions across all chatbots associated with your account.

GET/conversations

Request parameters

Headers

Authorizationstringrequired

Your API Key formatted as Bearer sk_live_…

Response

dataarray

A list of conversation objects.

idstring

The unique UUID identifier of the conversation session.

agent_idstring

The UUID of the chatbot that handled this conversation.

statusstring

The status of the conversation (e.g. active, completed).

metadataobject

Custom key-value data associated with this session.

cURL

curl -X GET https://app.picobot.dev/api/conversations \
  -H "Authorization: Bearer <token>"

Node.js

fetch('https://app.picobot.dev/api/conversations', {
  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", headers=headers)
print(response.json())

Java

HttpResponse<String> response = Unirest.get("https://app.picobot.dev/api/conversations")
  .header("Authorization", "Bearer <token>")
  .asString();

{
  "data": [
    {
      "id": "b7cd5a46-9878-479e-903c-03bc2a7d09a8",
      "agent_id": "91981020-f783-4544-ad96-39857ac589cb",
      "status": "completed",
      "metadata": {
        "browser": "Chrome",
        "country": "US"
      },
      "created_at": "2024-06-14T15:45:34+00:00"
    }
  ]
}