Skip to main content
POST
/
api
/
datasets
{
  "name": "My Dataset",
  "description": "Dataset description",
  "type": "sampling",
  "sampling": 50,
  "start_time": "2025-07-30T00:00:00Z",
  "end_time": "2025-08-01T00:00:00Z",
  "initial_log_filters": {
    "id": {
      "operator": "in",
      "value": ["log_id_1", "log_id_2"]
    }
  }
}

{
  "id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
  "name": "My Dataset",
  "type": "sampling",
  "status": "ready",
  "log_count": 2
}

Documentation Index

Fetch the complete documentation index at: https://docs.keywordsai.co/llms.txt

Use this file to discover all available pages before exploring further.

Create a dataset and specify which logs to include using filters.

​
Authentication

  • API key: Authorization: Bearer <API key>

​
Request Body

{
  "name": "My Dataset",
  "description": "Dataset description",
  "type": "sampling",
  "sampling": 50,
  "start_time": "2025-07-30T00:00:00Z",
  "end_time": "2025-08-01T00:00:00Z",
  "initial_log_filters": {
    "id": {
      "operator": "in",
      "value": ["log_id_1", "log_id_2"]
    }
  }
}

​
Examples

import requests

url = "https://api.keywordsai.co/api/datasets/"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

data = {
    "name": "My Dataset",
    "description": "Dataset with specific logs",
    "type": "sampling",
    "sampling": 50,
    "start_time": "2025-07-30T00:00:00Z",
    "end_time": "2025-08-01T00:00:00Z",
    "initial_log_filters": {
        "id": {
            "operator": "in",
            "value": ["log_id_1", "log_id_2"]
        }
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

​
Response

{
  "id": "6d0b2c7e-3a6a-4c09-9c7e-1f2d9e2d3f0a",
  "name": "My Dataset",
  "type": "sampling",
  "status": "ready",
  "log_count": 2
}