conversations

Send feedback on an answer

Records your user's thumb on one answer of an API key's conversation, with an optional comment, so the workspace sees where the assistant fell short (GET /v1/logs/conversations?rating=down). conversation_id and message_id come from the answer. Sending another thumb replaces the first; rating: null takes it back. Costs nothing. API keys only: thumbs on a personal chat are not available yet (feature_not_available).

POST/v1/conversations/{conversation_id}/messages/{message_id}/feedback

Request

curl --request POST \
  --url 'https://api.lookio.app/v1/conversations/<conversation_id>/messages/<message_id>/feedback' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "rating": "up"
}'

import json
import requests

url = "https://api.lookio.app/v1/conversations/<conversation_id>/messages/<message_id>/feedback"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"rating\":\"up\"}")

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

const response = await fetch("https://api.lookio.app/v1/conversations/<conversation_id>/messages/<message_id>/feedback", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "rating": "up"
  }),
});

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>/messages/<message_id>/feedback");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"rating\":\"up\"}");
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

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

package main

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

func main() {
  req, _ := http.NewRequest("POST", "https://api.lookio.app/v1/conversations/<conversation_id>/messages/<message_id>/feedback", bytes.NewBuffer([]byte("{\"rating\":\"up\"}")))
  req.Header.Set("Authorization", "<api-key>")
  req.Header.Set("Content-Type", "application/json")
  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>/messages/<message_id>/feedback"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"rating\":\"up\"}"))
    .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>/messages/<message_id>/feedback")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"rating\":\"up\"}"

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": {
    "conversation_id": "cnv_ca9xz837zsvb",
    "message_id": "msg_6ec9htp67dd7",
    "rating": "down",
    "comment": "The price is out of date."
  },
  "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>"
}

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

Use it to forward what a user of your product thought of an answer. conversation_id and message_id come from the answer: both are in the JSON answer and in the done event of a stream, and every message of Get a conversation has its id.

rating is up, down or null, which takes the thumb back. One answer holds one thumb: a new one replaces the old one and the totals follow. A comment goes only with up or down. Send end_user when you use end users: a conversation of another end user answers resource_not_found, like an answer id that is not in this conversation or that belongs to a question.

The thumb shows on the answer and in the workspace’s logs, where rating=down finds the conversations to review. It costs nothing.

API keys only. A person’s own chat answers feature_not_available: thumbs there are not available yet. See Feedback on answers. This is not the endpoint that reports a problem with Lookio itself: that is Submit feedback.

Authorizations

Authorizationbearerin headerrequired

Path parameters

conversation_idstringrequiredpattern: ^cnv_[abcdefghjkmnpqrstuvwxyz23456789]{12}$

message_idstringrequiredpattern: ^msg_[abcdefghjkmnpqrstuvwxyz23456789]{12}$

Header parameters

Idempotency-Keystringlength: 1–255 chars

A unique key for this request, such as a UUID, 1 to 255 visible ASCII characters. Send the same key when you retry: the first response is returned (with Idempotent-Replayed: true) instead of running the request again, for 24 hours, per credential. The same key on a different request is a 409 conflict. A streamed answer is not recorded.

Body

application/jsonrequired

ratingenum<string> | nullrequired

up or down: your user's thumb on this answer. null takes it back. Sending another thumb replaces the first, it never counts twice.

commentstringlength: ≤ 1000 chars

What your user wrote with the thumb, up to 1,000 characters. Only with up or down.

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

The end_user of the conversation, when you use them. When given, a conversation of another end user answers not found.

Response

application/json

Send feedback on an answer

dataobjectrequired

Show child attributes

data.conversation_idstringrequired

data.message_idstringrequired

data.ratingenum<string> | nullrequired

data.commentstringnullrequired

request_idstringrequired

curl --request POST \ --url 'https://api.lookio.app/v1/conversations/<conversation_id>/messages/<message_id>/feedback' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "rating": "up" }'

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

Send feedback on an answer

Authorizations

Path parameters

Header parameters

Body

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown