API referenceTables
Table_create
POST
/tablesRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
POST /tables body — pure storage schema + population (ADR-0069).
Ingestion is wired separately by creating + attaching Sources.
⚠️ deny_unknown_fields, deliberately (one of four write DTOs — see
organization/dto.rs for the documented default and why these four depart
from it): a body carrying a dead key (category, a source's kind) must be
refused, not silently dropped — the field-rename this request survived
would otherwise accept bodies written for the shape it replaced.
Response Body
application/json
curl -X POST "https://example.com/tables" \ -H "Content-Type: application/json" \ -d '{ "name": "string" }'{ "columns": [ { "data_type": "string", "description": "string", "name": "string", "nullable": true } ], "created_at": "string", "description": "string", "id": "string", "is_managed": true, "is_readonly": true, "is_system": true, "kind": "event", "last_ingested_at": "string", "max_versions": 0, "name": "string", "org_id": "string", "owner_team_id": "string", "population": { "event_time_field": "string", "kind": "source", "query": null, "rule_id": "string" }, "result_of_query_id": "string", "row_count": 0, "size_bytes": 0, "table_name": "string", "updated_at": "string", "warnings": [ { "code": "string", "message": "string" } ]}