diegosouzapw 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.