conversations

Get a conversation

One of the caller's conversations with its messages and citations, and each message's id (an answer's id is what the feedback endpoint takes) and thumb. A person's chats are personal: someone else's answers 404, admins included. An API key reads the conversations it started, and with end_user only that person's. assistant_deleted is true when the assistant is gone: the conversation stays readable but cannot be continued.

GET/v1/conversations/{conversation_id}

Request

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

import json
import requests

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

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

const response = await fetch("https://api.lookio.app/v1/conversations/<conversation_id>", {
  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/<conversation_id>");
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/<conversation_id>", 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/<conversation_id>"))
    .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/<conversation_id>")
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>",
    "assistant_id": "<string>",
    "assistant_deleted": true,
    "title": "<string>",
    "channel": "personal",
    "end_user": null,
    "message_count": 123,
    "created_at": "<string>",
    "updated_at": "<string>",
    "messages": [
      {
        "id": "<string>",
        "role": "user",
        "content": "<string>",
        "citations": [
          {
            "resource_id": "<string>",
            "title": "<string>",
            "text": "<string>",
            "n": 123,
            "section": [
              "<string>"
            ],
            "page": 123,
            "url": "<string>",
            "source": "<string>"
          }
        ],
        "rating": "up",
        "rating_comment": null,
        "created_at": "<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>"
}

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

Requires assistants:read.

A person’s chat is personal: you read your own, and someone else’s answers resource_not_found, admins included. An API key reads the conversations it started. Send end_user to make sure it is that person’s: a conversation of another end user answers resource_not_found.

assistant_deleted is true when the assistant is gone: the conversation stays readable but cannot be continued. Each answer carries the citations it relied on at the time.

Every message has an id. An answer’s id is what Send feedback on an answer takes, and its rating and rating_comment show the thumb already sent (always null in a person’s chat, which takes none yet).

Find a conversation’s id with List conversations.

Authorizations

Authorizationbearerin headerrequired

Path parameters

conversation_idstringrequiredpattern: ^cnv_[abcdefghjkmnpqrstuvwxyz23456789]{12}$

Query parameters

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

API keys only: the end_user of the conversation. When given, a conversation of another end user answers not found.

Response

application/json

Retrieve a conversation

dataobjectrequired

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.

data.messagesobject[]required

Show child attributes

data.messages.idstringrequired

The message's id. An answer's id is what the feedback endpoint takes.

data.messages.roleenum<string>requiredone of: user, assistant

data.messages.contentstringrequired

data.messages.citationsobject[]required

Show child attributes

data.messages.citations.resource_idstringrequired

The cited resource. Empty for a public assistant of another workspace: its resources stay its own.

data.messages.citations.titlestringrequired

data.messages.citations.textstringrequired

The passage the answer relies on.

data.messages.citations.ninteger

The number the answer cites it by, as [1].

data.messages.citations.sectionstring[]

data.messages.citations.pageinteger

data.messages.citations.urlstring

data.messages.citations.sourcestring

The cited resource's source, when it has one.

data.messages.ratingenum<string> | nullrequired

The thumb sent for this answer. Always null in a personal chat (no thumbs there yet).

data.messages.rating_commentstringnullrequired

The comment sent with the thumb.

data.messages.created_atstringrequired

request_idstringrequired

Get a conversation

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