Get a conversation - QX Labs Docs

GET

conversations

{conversation_id}

items

cURL

curl "https://api.qxlabs.com/v1/conversations/8d2c4e6f8a0b1c3d5e7f9a1b3c5d7e9f/items?limit=20" \
  -H "Authorization: Bearer <YOUR_QX_API_KEY>"

from openai import OpenAI

client = OpenAI(base_url="https://api.qxlabs.com/v1", api_key="<YOUR_QX_API_KEY>")

# The SDK fetches the next pages as you go
for item in client.conversations.items.list("8d2c4e6f8a0b1c3d5e7f9a1b3c5d7e9f", limit=20):
    print(item.type, item.id)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.qxlabs.com/v1", apiKey: "<YOUR_QX_API_KEY>" });

// The SDK fetches the next pages as you go
for await (const item of client.conversations.items.list("8d2c4e6f8a0b1c3d5e7f9a1b3c5d7e9f", { limit: 20 })) {
  console.log(item.type, item.id);
}

{
  "object": "list",
  "data": [
    {
      "type": "message",
      "id": "msg_77c0a1b2c3d4",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "You have 3 unread emails today...",
          "annotations": []
        }
      ]
    },
    {
      "type": "message",
      "id": "3f9a1c2b4d5e6f708192a3b4",
      "role": "user",
      "status": "completed",
      "content": [
        {
          "type": "input_text",
          "text": "Summarise my unread emails from today"
        }
      ]
    }
  ],
  "first_id": "msg_77c0a1b2c3d4",
  "last_id": "3f9a1c2b4d5e6f708192a3b4",
  "has_more": false
}

{
  "error": {
    "message": "limit must be from 1 to 100.",
    "type": "invalid_request_error",
    "param": null,
    "code": null
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Your QX API key. The X-API-Key header works too

Path Parameters

conversation_id

string

required

The conversation's ID, from a response's conversation

Query Parameters

limit

integer

default:20

Turns per page, from 1 to 100

after

string

The previous page's last_id

order

enum<string>

default:desc

Only newest first

Available options:

desc

Response

A page of the conversation

object

string

data

Item · object[]

message items for your and the agent's messages, reasoning items for the agent's thinking, mcp_call items for tool calls, and mcp_approval_request items for approval requests still open. Newest first

Show child attributes

first_id

string

last_id

string

has_more

boolean

Whether there are earlier turns

cURL

curl "https://api.qxlabs.com/v1/conversations/8d2c4e6f8a0b1c3d5e7f9a1b3c5d7e9f/items?limit=20" \
  -H "Authorization: Bearer <YOUR_QX_API_KEY>"

from openai import OpenAI

client = OpenAI(base_url="https://api.qxlabs.com/v1", api_key="<YOUR_QX_API_KEY>")

# The SDK fetches the next pages as you go
for item in client.conversations.items.list("8d2c4e6f8a0b1c3d5e7f9a1b3c5d7e9f", limit=20):
    print(item.type, item.id)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.qxlabs.com/v1", apiKey: "<YOUR_QX_API_KEY>" });

// The SDK fetches the next pages as you go
for await (const item of client.conversations.items.list("8d2c4e6f8a0b1c3d5e7f9a1b3c5d7e9f", { limit: 20 })) {
  console.log(item.type, item.id);
}

{
  "object": "list",
  "data": [
    {
      "type": "message",
      "id": "msg_77c0a1b2c3d4",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "You have 3 unread emails today...",
          "annotations": []
        }
      ]
    },
    {
      "type": "message",
      "id": "3f9a1c2b4d5e6f708192a3b4",
      "role": "user",
      "status": "completed",
      "content": [
        {
          "type": "input_text",
          "text": "Summarise my unread emails from today"
        }
      ]
    }
  ],
  "first_id": "msg_77c0a1b2c3d4",
  "last_id": "3f9a1c2b4d5e6f708192a3b4",
  "has_more": false
}

{
  "error": {
    "message": "limit must be from 1 to 100.",
    "type": "invalid_request_error",
    "param": null,
    "code": null
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}