conversations

List conversations

The caller's own conversations, latest activity first, optionally with one assistant (assistant_id). For a person: their chats, personal, nobody else's is listed, admins included. For an API key: the conversations its questions started, optionally of one end_user. channel says which it is. A conversation whose assistant was deleted stays listed with assistant_deleted: true. This is not the workspace's view of what people asked: that is GET /v1/logs/conversations.

GET/v1/conversations

Request

curl --request GET \
  --url 'https://api.lookio.app/v1/conversations' \
  --header 'Authorization: <api-key>'

import json
import requests

url = "https://api.lookio.app/v1/conversations"
headers = {
  "Authorization": "<api-key>"
}

response = requests.request("GET", url, headers=headers)
print(response.json())

const response = await fetch("https://api.lookio.app/v1/conversations", {
  method: "GET",
  headers: {
    "Authorization": "<api-key>"
  },
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.lookio.app/v1/conversations");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.lookio.app/v1/conversations", nil)
  req.Header.Set("Authorization", "<api-key>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.lookio.app/v1/conversations"))
    .header("Authorization", "<api-key>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.lookio.app/v1/conversations")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "<api-key>"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": [
    {
      "id": "cnv_ca9xz837zsvb",
      "assistant_id": "ast_66xcnwtzj8vt",
      "assistant_deleted": false,
      "title": "What is the refund window?",
      "channel": "api",
      "end_user": "user_42",
      "message_count": 4,
      "created_at": "2026-10-12T09:30:00.000Z",
      "updated_at": "2026-10-12T09:30:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "request_id": "req_01K9X7M2Q4"
}

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

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

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

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

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

Requires assistants:read.

What you list depends on the credential. A person lists their own chats, which are personal: nobody else’s is listed, admins included. An API key lists the conversations its own questions started. channel says which: personal, api (REST, CLI, SDK) or mcp.

Filter with assistant_id, and, for an API key, with end_user to list one of your users’ conversations. Results come latest activity first, and you page with cursor: see Pagination.

A conversation whose assistant was deleted stays in the list with assistant_deleted: true. See Conversations and end users.

This is not the workspace’s view of what people asked: that is List the workspace’s conversation logs.

Open one with Get a conversation.

Authorizations

Authorizationbearerin headerrequired

Query parameters

limitintegerrange: 1–100

Number of items to return. Values outside 1-100 are clamped, and the response reports the limit actually applied.

cursorstringpattern: ^cnv_[abcdefghjkmnpqrstuvwxyz23456789]{12}$

Pass next_cursor from the previous page, unchanged.

assistant_idstringpattern: ^ast_[abcdefghjkmnpqrstuvwxyz23456789]{12}$

Only the conversations with this assistant.

end_userstringpattern: ^[\w.@:+\-]{1,200}$

API keys only: only the conversations of this end_user, the id you sent with the questions.

Response

application/json

List your conversations

dataobject[]required

Show child attributes

data.idstringrequiredpattern: ^cnv_[abcdefghjkmnpqrstuvwxyz23456789]{12}$

data.assistant_idstringrequired

data.assistant_deletedbooleanrequired

True when the assistant was deleted since: the conversation stays readable but cannot be continued.

data.titlestringrequired

Defaults to the first 100 characters of the opening question until renamed (PATCH /v1/conversations/{conversation_id}, up to 100 characters).

data.channelenum<string>requiredone of: personal, api, mcp

personal: a person's own chat (the app, or their connection). api: an API key's conversation (REST, CLI, SDK). mcp: an API key's conversation through the MCP server.

data.end_userstringnullrequired

The end_user sent with the questions of an API key's conversation. Null for a personal chat and when none was sent.

data.message_countintegerrequired

Questions and answers together.

data.created_atstringrequired

data.updated_atstringrequired

The last activity. Conversations are listed by it, latest first.

has_morebooleanrequired

True when another page follows: pass next_cursor back as cursor.

next_cursorstringnullrequired

Pass it back unchanged as cursor. Null on the last page.

limitintegerrequired

The page size actually applied.

request_idstringrequired

{ "data": [ { "id": "cnv_ca9xz837zsvb", "assistant_id": "ast_66xcnwtzj8vt", "assistant_deleted": false, "title": "What is the refund window?", "channel": "api", "end_user": "user_42", "message_count": 4, "created_at": "2026-10-12T09:30:00.000Z", "updated_at": "2026-10-12T09:30:00.000Z" } ], "has_more": false, "next_cursor": null, "request_id": "req_01K9X7M2Q4" }

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

List conversations

Authorizations

Query parameters

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown