Administration & Settings
The Administration area is where an organization administrator configures Colrows: data connections, governance, people, authentication, keys, and billing. Organization settings are admin-only; other admins and curators manage the areas relevant to their role.
What administrators configure
- Organization settings - cloud platforms, personas, notification recipients, token quota and usage, billing, and security/authentication realms.
- Datasources - create, test, update, and delete connections; set each datasource's asset scope, discovery policy, and metadata enrichment; browse its asset catalog. See Datasources.
- Analytics platforms - connect, discover, and test BI sources such as Apache Superset and Microsoft Power BI as inputs to the semantic layer.
- Governance - Access policies and Redaction policies.
- People - users, user groups, administrators, and subject-matter experts / curators; assign personas.
- Assistants - configure the embeddable AI assistants used in embedding.
- Authentication (SSO) - LDAP, OIDC, and SAML realms, including SAML certificate upload. See Users & SSO.
- API keys - create, list, and delete organization API keys (used by the integration login flow).
- Billing - billing settings, cloud-marketplace activation, and metering.
Manage via API
Most administration lives on the platform's system and datasource APIs; these require an administrator identity unless noted:
| Operation | Endpoint |
|---|---|
| Organization settings | GET /api/sys/org/get · PUT /api/sys/org/complete/update |
| API keys | GET·POST /api/sys/org/api-keys · DELETE /api/sys/org/api-keys/{id} |
| Analytics platforms | GET /api/sys/org/analytics-platforms (+ per-platform connect/test) |
| Admins & experts | PUT /api/sys/org/admins/update · PUT /api/sys/org/smes/update |
| Personas | POST /api/sys/org/personas |
| SAML certificate | POST /api/sys/org/security/saml/certificate/upload |
| Datasource connections | POST /api/datasource/create · /test · /update · DELETE /api/datasource/delete/{id} |
Roles.
Two roles are write-capable across Colrows: administrators (org configuration, users, keys, billing, governance) and curators (the semantic layer - Catalog, Verified Queries, and Review & Curation).