X-Splendor-Tenant-Id header selects the workspace; the token’s role within that workspace decides what it can do.
The roles
- Member — read and query. Members can search, list datasets and runs, read schemas, create and read views, run exports, and upload to a source.
- Admin — everything members can do, plus operations that create, change, or delete data: sources, connectors, detections, datasets, ingest tokens, reindex and dead-letter-queue actions, and field promotion.
What requires admin
| Area | Member | Admin |
|---|---|---|
| Search, SQL, semantic | ✅ | ✅ |
| Read datasets, schemas, readiness | ✅ | ✅ |
| Views (create, read, delete) | ✅ | ✅ |
| Exports | ✅ | ✅ |
| Upload to a source / stream logs | ✅ | ✅ |
| Read sources, connectors, detections | ✅ | ✅ |
| Read audit, usage, DLQ, jobs | ✅ | ✅ |
| Create / update / delete sources & connectors | — | ✅ |
| Create / update / delete detections | — | ✅ |
| Delete a dataset, rebuild schema, reindex | — | ✅ |
| Rotate / revoke ingest tokens | — | ✅ |
| Retry dead-letter failures, promote fields | — | ✅ |
403.
Checking a caller’s role
GET /v1/me returns the caller’s role and effective capability per tenant:
is_admin reflects whether the caller can perform admin operations in that tenant. How it is derived depends on the tenant’s plan — see Plans & RBAC.