API Reference
Schemas
Endpoints to create, list, update and delete schemas.
POST/schemas
Creates a new schema.
json — body
{
"name": "Contact Extraction",
"slug": "contact-extraction",
"description": "Extracts contact data from free text",
"definition": {
"type": "object",
"required": ["name", "email"],
"properties": {
"name": { "type": "string" },
"email": { "type": "string" }
}
},
"safe_fallback": { "name": null, "email": null }
}
GET/schemas
Lists all project schemas.
json — response
{
"schemas": [
{
"id": "cmonautso0002ph012m23m4au",
"name": "Contact Extraction",
"slug": "contact-extraction",
"version": 1,
"definition": { ... },
"safe_fallback": { ... },
"created_at": "2026-05-01T19:21:39.634Z"
}
]
}
GET/schemas/:id
Fetches a schema by ID.
PUT/schemas/:id
Updates a schema. Creates a new version automatically.
DELETE/schemas/:id
Removes a schema. Linked executions are kept.