widgets

List a widget's conversations

The conversations anonymous visitors had through this widget, latest first: the same as GET /v1/logs/conversations?widget_id=…, with who (end_user is the visitor's random id), how many messages, the visitors' thumbs and what it cost. Paginate with cursor: pass next_cursor from the previous page. Visitors' conversations are kept 90 days.

GET/v1/widgets/{widget_id}/conversations

Request

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

import json
import requests

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

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

const response = await fetch("https://api.lookio.app/v1/widgets/<widget_id>/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/widgets/<widget_id>/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/widgets/<widget_id>/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/widgets/<widget_id>/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/widgets/<widget_id>/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": "<string>",
      "channel": "widget",
      "title": "<string>",
      "assistant": {
        "id": "<string>",
        "name": null
      },
      "widget": {
        "id": "<string>",
        "name": "<string>"
      },
      "api_key": {
        "id": "<string>",
        "name": null
      },
      "end_user": null,
      "message_count": 123,
      "credits": 123,
      "thumbs_up": 123,
      "thumbs_down": 123,
      "created_at": "<string>",
      "updated_at": "<string>",
      "locked": true
    }
  ],
  "has_more": true,
  "next_cursor": null,
  "limit": 123,
  "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>"
}

{
  "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.

This is List the workspace’s conversation logs filtered on one widget, so the entries have the same shape: channel is widget, and end_user is the visitor’s random id, the same for every conversation from the same browser. Visitors are anonymous. Results come latest first, and you page with cursor: see Pagination.

Conversations are kept 90 days after their last message. Questions asked in the app’s preview are not listed. Use the thumbs down to find where the assistant fails. See Visitors’ conversations.

Authorizations

Authorizationbearerin headerrequired

Path parameters

widget_idstringrequiredpattern: ^wdg_[abcdefghjkmnpqrstuvwxyz23456789]{12}$

Query parameters

limitintegerrange: 1–100

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

cursorstringlength: 1–40 chars

Pass next_cursor from the previous page, unchanged.

Response

application/json

List a widget's conversations

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

{ "data": [ { "id": "<string>", "channel": "widget", "title": "<string>", "assistant": { "id": "<string>", "name": null }, "widget": { "id": "<string>", "name": "<string>" }, "api_key": { "id": "<string>", "name": null }, "end_user": null, "message_count": 123, "credits": 123, "thumbs_up": 123, "thumbs_down": 123, "created_at": "<string>", "updated_at": "<string>", "locked": true } ], "has_more": true, "next_cursor": null, "limit": 123, "request_id": "<string>" }

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

List a widget's conversations

Authorizations

Path parameters

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