Conversations API

List all sessions in the authenticated project, newest activity first, with metadata for each.

GET/v1/conversations

Authentication

Requires a secret API key passed as a Bearer token (Authorization: Bearer carrier_sk_…).

Request body

Field	Type	Description
limit	query, 1–100	Page size. Default 20.
offset	query	Number of records to skip. Default 0.

Example request

bash

curl "https://api.carrieros.ai/v1/conversations?limit=20&offset=0" \
  -H "Authorization: Bearer carrier_sk_live_YOUR_KEY"

Response

Field	Type	Description
conversations[].session_id	string	The session identifier.
conversations[].title	string	Session title.
conversations[].message_count	number	Messages in the session.
conversations[].last_activity	string	ISO timestamp of the latest message.
conversations[].created_at	string	ISO creation timestamp.
pagination	object	{ total, limit, offset }.

Example response

json

{
  "success": true,
  "data": {
    "conversations": [
      {
        "session_id": "9c4f…",
        "title": "OAuth research",
        "message_count": 4,
        "last_activity": "2026-07-27T10:05:00.000Z",
        "created_at": "2026-07-27T10:00:00.000Z"
      }
    ],
    "pagination": { "total": 1, "limit": 20, "offset": 0 }
  }
}

Possible errors

Code	HTTP	When it occurs
INVALID_API_KEY	401	The key is missing, malformed, revoked, or inactive.