Query Conclusions

curl --request POST \
  --url https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "top_k": 10,
  "distance": 0.5,
  "filters": {}
}
'

import requests

url = "https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query"

payload = {
    "query": "<string>",
    "top_k": 10,
    "distance": 0.5,
    "filters": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: '<string>', top_k: 10, distance: 0.5, filters: {}})
};

fetch('https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'top_k' => 10,
    'distance' => 0.5,
    'filters' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"top_k\": 10,\n  \"distance\": 0.5,\n  \"filters\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"top_k\": 10,\n  \"distance\": 0.5,\n  \"filters\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"top_k\": 10,\n  \"distance\": 0.5,\n  \"filters\": {}\n}"

response = http.request(request)
puts response.read_body

[
  {
    "id": "<string>",
    "content": "<string>",
    "observer_id": "<string>",
    "observed_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "session_id": "<string>",
    "level": "explicit",
    "source_ids": [
      "<string>"
    ],
    "source_message_ids": [
      "<string>"
    ],
    "times_derived": 1
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

POST

workspaces

{workspace_id}

conclusions

query

Query Conclusions

curl --request POST \
  --url https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "top_k": 10,
  "distance": 0.5,
  "filters": {}
}
'

import requests

url = "https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query"

payload = {
    "query": "<string>",
    "top_k": 10,
    "distance": 0.5,
    "filters": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: '<string>', top_k: 10, distance: 0.5, filters: {}})
};

fetch('https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'top_k' => 10,
    'distance' => 0.5,
    'filters' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"top_k\": 10,\n  \"distance\": 0.5,\n  \"filters\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"top_k\": 10,\n  \"distance\": 0.5,\n  \"filters\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.honcho.dev/v3/workspaces/{workspace_id}/conclusions/query")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"top_k\": 10,\n  \"distance\": 0.5,\n  \"filters\": {}\n}"

response = http.request(request)
puts response.read_body

[
  {
    "id": "<string>",
    "content": "<string>",
    "observer_id": "<string>",
    "observed_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "session_id": "<string>",
    "level": "explicit",
    "source_ids": [
      "<string>"
    ],
    "source_message_ids": [
      "<string>"
    ],
    "times_derived": 1
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspace_id

string

required

Body

application/json

Semantic search parameters for Conclusions

query

string

required

Semantic search query

top_k

integer

default:10

Number of results to return

Required range: 1 <= x <= 100

distance

number | null

Maximum cosine distance threshold for results

Required range: 0 <= x <= 1

filters

Filters · object | null

Additional filters to apply

Response

Successful Response

string

required

content

string

required

observer_id

string

required

The peer who made the conclusion

observed_id

string

required

The peer the conclusion is about

created_at

string<date-time>

required

session_id

string | null

level

enum<string>

default:explicit

Reasoning level of the conclusion: 'explicit' (directly extracted from messages) or 'deductive'/'inductive'/'contradiction' (derived during dreaming).

Available options:

explicit,

deductive,

inductive,

contradiction

source_ids

string[]

IDs of the conclusions this one was derived from: premises for 'deductive', supporting sources for 'inductive', conflicting conclusions for 'contradiction'. Empty for 'explicit' conclusions, which derive from messages rather than from other conclusions.

source_message_ids

string[] | null

IDs of the messages the deriver cited as evidence for an 'explicit' conclusion, in citation order. Evidence may include messages from peers other than the observed one. None for derived levels and for conclusions written before citations were recorded.

times_derived

integer

default:1

Number of times this conclusion has been independently derived.

API Documentation

workspaces

dreams

peers

sessions

scopes

messages

conclusions

webhooks

miscellaneous

Query Conclusions

Authorizations

Path Parameters

Body

Response