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

| Resource | Method | Endpoint | Description | |----------|--------|----------|-------------| | Teams | GET | /teams | List user's teams | | Teams | GET | /teams/:teamId | Get team by ID | | Datasets | GET | /datasets | List datasets | | Datasets | POST | /datasets | Create dataset | | Datasets | GET | /datasets/:datasetId | Get dataset by ID | | Datasets | PUT | /datasets/:datasetId | Update dataset | | Datasets | DELETE | /datasets/:datasetId | Delete dataset | | Tables | GET | /dataset-tables | List tables | | Tables | POST | /dataset-tables | Create table with schema | | Tables | GET | /dataset-tables/:tableId | Get table by ID | | Tables | PUT | /dataset-tables/:tableId | Update table metadata | | Tables | DELETE | /dataset-tables/:tableId | Delete table | | Rows | POST | /dataset-tables/:tableId/rows?mode=append | Insert rows | | Rows | POST | /dataset-tables/:tableId/rows?mode=upsert | Upsert rows | | Rows | POST | /dataset-tables/:tableId/rows?mode=delete | Delete rows by PK | | Queries | POST | /dataset-tables/:tableId/query | Execute SQL query | | Schema | GET | /dataset-tables/:tableId/schema | Get table schema | | Pipelines | GET | /pipelines | List pipelines | | Pipelines | POST | /pipelines | Create pipeline | | Pipelines | GET | /pipelines/:pipelineId | Get pipeline by ID | | Pipelines | PUT | /pipelines/:pipelineId | Update pipeline | | Pipelines | POST | /pipelines/:pipelineId/trigger | Trigger pipeline execution | | Executions | GET | /pipeline-executions | List executions | | Executions | GET | /pipeline-executions/:executionId | Get execution status | | Knowledge Bases | GET | /knowledge-bases | List knowledge bases | | Knowledge Bases | POST | /knowledge-bases | Create knowledge base | | Knowledge Bases | GET | /knowledge-bases/:kbId | Get knowledge base | | Knowledge Bases | POST | /knowledge-bases/:kbId/sources | Add source (file or table) | | Knowledge Bases | POST | /knowledge-bases/:kbId/query | Vector search query | | Files | POST | /files | Upload file | | Files | GET | /files/:fileId | Get file metadata | | API Tokens | GET | /api-tokens | List API tokens | | API Tokens | POST | /api-tokens | Create API token |

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.