Skip to main content
The controller is the management plane of a Pinot cluster. Use these endpoints to create and change tables and schemas, upload and inspect segments, manage tenants and instances, schedule minion tasks, and read cluster state. Every call goes to the controller URL of your StarTree Cloud environment with an Authorization: Bearer <token> header. On multi-tenant clusters, also pass your workspace ID in the database header. See the API introduction for how to get both. The groups below follow the controller’s own tags. The most used ones:

Table

Create, update, validate, rebalance, pause, and delete tables.

Schema

Add and update schemas, and validate them before use.

Segment

Upload, reload, delete, and inspect segments and their metadata.

Task

Schedule and monitor minion tasks and their cron jobs.
StarTree adds its own controller endpoints on top of the Pinot ones, for example atomic ingestion, restream, and upsert snapshots. Those are listed separately under StarTree Extension APIs.