logs

List the workspace's conversation logs

What people outside the workspace asked, from every channel: visitors of your widgets, and the users of your own product who reach an assistant through an API key (REST, CLI, SDK) or the MCP server. Latest activity first, with who asked (end_user), through what (widget or api_key), how many messages, what it cost and the thumbs. Filter by channel, widget_id, api_key_id, assistant_id, rating (down finds where the assistant failed), end_user, q (words in any message) and from/to, and paginate with cursor. Read one in full with GET /v1/logs/conversations/{conversation_id} and the figures above the list with GET /v1/logs/conversations/stats. Members' own chats with assistants are personal and never appear here. A conversation is kept 90 days after its last message. Needs the right to edit assistants; an API key sees the conversations of its own assistants. Costs nothing.

GET/v1/logs/conversations

Request

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

import json
import requests

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

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

const response = await fetch("https://api.lookio.app/v1/logs/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/logs/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/logs/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/logs/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/logs/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",
      "channel": "api",
      "title": "What is the refund window?",
      "assistant": {
        "id": "ast_66xcnwtzj8vt",
        "name": "Support"
      },
      "widget": null,
      "api_key": {
        "id": "k_7f3a9c",
        "name": "Help centre backend"
      },
      "end_user": "user_42",
      "message_count": 4,
      "credits": 60,
      "thumbs_up": 0,
      "thumbs_down": 1,
      "created_at": "2026-10-12T09:30:00.000Z",
      "updated_at": "2026-10-12T09:30:00.000Z",
      "locked": false
    }
  ],
  "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:write.

The logs hold the conversations of the visitors of your widgets and of the users of your product who ask through an API key or the MCP server. A member’s own chats are personal and never appear. Results come latest activity first, and you page with cursor: see Pagination.

Each entry names the channel (widget, api or mcp), the widget or the api_key it came through, the end_user, how many messages it holds, what it cost and its thumbs. Narrow the list with channel (comma-separated), widget_id, api_key_id, assistant_id, rating, end_user, q (words in any message) and from and to. rating=down lists the conversations where someone gave a thumbs down.

A person needs the right to edit assistants, or the call fails with permission_denied. An API key reads the conversations of its own assistants. See Logs.

Open one with Retrieve a logged conversation.

Authorizations

Authorizationbearerin headerrequired

Query parameters

channelstringlength: ≥ 1 chars

Only the conversations from these channels, comma-separated: widget (visitors of a widget), api (an API key through REST, the CLI or the SDK), mcp (an API key through the MCP server). Default: all three.

widget_idstringpattern: ^wdg_[abcdefghjkmnpqrstuvwxyz23456789]{12}$

Only this widget's visitors.

api_key_idstringlength: 1–64 chars

Only the conversations asked with this API key (the api_key.id of a conversation in these logs).

assistant_idstringpattern: ^ast_[abcdefghjkmnpqrstuvwxyz23456789]{12}$

Only the conversations with this assistant.

ratingenum<string>one of: up, down, rated, unrated

down: at least one thumbs down (where the assistant failed). up: at least one thumbs up. rated: any thumb. unrated: none.

end_userstringlength: 1–200 chars

Only this person: a widget visitor's random id, or the end_user your product sends with its questions.

qstringlength: 1–200 chars

Words in the title or in any question or answer, without regard to case.

fromstring

Only conversations with activity since this ISO 8601 date or timestamp.

tostring

Only conversations started before this ISO 8601 date or timestamp.

cursorstringlength: 1–40 chars

Pass next_cursor from the previous page, unchanged.

limitintegerrange: 1–100

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

Response

application/json

List the workspace's conversation logs

dataobject[]required

Show child attributes

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

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

widget: a visitor on your website. api: an API key through REST, the CLI or the SDK. mcp: an API key through the MCP server.

data.titlestringrequired

The first question.

data.assistantobjectrequired

Show child attributes

data.assistant.idstringrequired

data.assistant.namestringnullrequired

Null when the assistant was deleted.

data.widgetobject | nullrequired

The widget, for the widget channel.

Show child attributes

data.widget.idstringrequired

data.widget.namestringrequired

data.api_keyobject | nullrequired

The API key, for the api and mcp channels.

Show child attributes

data.api_key.idstringrequired

data.api_key.namestringnullrequired

Null once the key is deleted.

data.end_userstringnullrequired

Who was asking: a widget visitor's random id, or the end_user the product sent. Null when an API key sent none.

data.message_countintegerrequired

Questions and answers together.

data.creditsintegerrequired

What this conversation's answers cost.

data.thumbs_upintegerrequired

data.thumbs_downintegerrequired

data.created_atstringrequired

data.updated_atstringrequired

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

data.lockedbooleanrequired

Older than the plan keeps conversations readable (7 days on Free, 90 on Starter, 1 year on Pro, from the last activity). Its text is hidden, not yet deleted: title is then a date and messages is empty, and a higher plan shows it again.

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

List the workspace's conversation logs

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