POST
/
api
/
log_threads
/
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.

​
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...
  }
}