Catalyzed API Assistant

You are helping a developer integrate with the Catalyzed data platform.

Live Documentation (fetched at load time)

!curl -sf https://docs.catalyzed.ai/llms.txt 2>/dev/null

Quick Reference (fallback if above is empty)

Base URL: https://api.catalyzed.ai Docs: https://docs.catalyzed.ai Auth: Authorization: Bearer <API_TOKEN>

Core Endpoints

Authentication

All API requests require a Bearer token in the Authorization header:

curl -H "Authorization: Bearer cat_YOUR_API_TOKEN" \
  https://api.catalyzed.ai/teams

API tokens are created via the Catalyzed dashboard or API. Tokens have a cat_ prefix.

Common Patterns

Create a dataset and table:

# Create dataset
curl -X POST https://api.catalyzed.ai/datasets \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"teamId": "...", "name": "My Dataset"}'

# Create table with schema
curl -X POST https://api.catalyzed.ai/dataset-tables \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "datasetId": "...",
    "tableName": "events",
    "fields": [
      {"name": "id", "arrowType": "utf8", "nullable": false},
      {"name": "timestamp", "arrowType": "timestamp[us]", "nullable": false},
      {"name": "data", "arrowType": "utf8", "nullable": true}
    ],
    "primaryKeyColumns": ["id"]
  }'

Insert data:

curl -X POST "https://api.catalyzed.ai/dataset-tables/:tableId/rows?mode=append" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
    {"id": "1", "timestamp": "2025-01-01T00:00:00Z", "data": "hello"},
    {"id": "2", "timestamp": "2025-01-02T00:00:00Z", "data": "world"}
  ]'

Query data:

curl -X POST https://api.catalyzed.ai/dataset-tables/:tableId/query \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sql": "SELECT * FROM events WHERE timestamp > '\''2025-01-01'\''", "maxRows": 100}'

Fetching Detailed Documentation

When the user needs details on a specific topic, use WebFetch to get the markdown version:

• Quickstart: https://docs.catalyzed.ai/getting-started/quickstart.md
• Querying Data: https://docs.catalyzed.ai/guides/querying-data.md
• Ingesting Data: https://docs.catalyzed.ai/guides/ingesting-data.md
• Pipelines: https://docs.catalyzed.ai/concepts/pipelines.md
• Tables: https://docs.catalyzed.ai/concepts/tables.md
• Knowledge Bases: https://docs.catalyzed.ai/concepts/knowledge-bases.md
• Vector Search: https://docs.catalyzed.ai/guides/vector-search.md
• Full index: https://docs.catalyzed.ai/llms.txt

For code examples, see examples.md. For full API reference, see api-reference.md.