Skip to main content
POST
/
api
/
log_threads
/
Thread list
curl --request POST \
  --url https://api.keywordsai.co/api/log_threads/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "filters": {
    "thread_identifier": "<string>",
    "organization_key_id": "<string>",
    "customer_identifier": "<string>"
  }
}'
This endpoint retrieves log threads based on specified filters and pagination parameters.

​
Authentication

Requires API key authentication via Bearer token in the Authorization header.

​
Query Params

​
page
integer
default:1
The page number to retrieve.
​
page_size
integer
default:100
The number of items per page. Maximum is 1000.
​
environment
string
default:"prod"
This is controlled by the API key. A prod API key creates prod threads, test key creates test threads.

​
Post params

​
filters
object
default:{}
The filters to apply to the threads.
​
thread_identifier
string
The identifier of the thread. Operators: "" (is), “in” (is in list)
​
operator
string
The operator to use. Operators: "" (is), “in” (is in list)
​
value
array
The value to filter by.
​
organization_key_id
string
The ID of the organization. Operators: "" (is), “not” (is not)
​
operator
string
The operator to use. Operators: "" (is), “not” (is not)
​
value
array
The value to filter by.
​
customer_identifier
string
Filter by customer ID Operators: "" (is), “not” (is not)
​
operator
string
The operator to use. Operators: "" (is), “not” (is not)
​
value
array
The value to filter by.

​
Example

Python
import requests
import json
url = "https://api.keywordsai.co/api/log_threads/?page_size=100"
payload = json.dumps({
  "filters": {
    "thread_identifier": {
      "operator": "in",
      "value": [
        "thread_identifier_1"
      ]
    }
  }
})
headers = {
  'Authorization': 'Bearer YOUR_API_KEY',
  'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)

​
Response

{
  "results": [
    {
      "thread_identifier": "thread_id_1",
      "environment": "prod",
      "log_count": 21
    }
  ],
  "count": 1,
  "previous": null,
  "next": null,
  "current_filters": {
    "thread_identifier": {
      "operator": "in",
      "value": ["thread_id_1"]
    }
  },
  "filters_data": {
    "thread_identifier": {
      "display_name": "Thread ID",
      "metric": "thread_identifier",
      "operator_choices": [
        {"name": "is", "value": ""},
        {"name": "in", "value": "in"}
      ],
      "value_choices": [],
      "value_field_type": "text",
      "hidden": false
    },
    // Other available filters and their options...
  }
}