Organization

The organizations resource manages multi-tenant organization contexts (companies, schools, teams) in Cognita’s AI meeting platform. Each organization operates as an isolated tenant with:

Custom data retention policies

Education/business-specific configurations

Integrated billing and compliance controls

Role-based access to platform features

Key Use Cases

Onboard new schools/corporate clients

Configure education-specific LMS integrations

Enforce FERPA/GDPR compliance per tenant

Manage billing plans and feature flags

Authentication

All requests require:

Header: Authorization: Bearer <JWT>

Scopes: org:read, org:write, org:admin (role-based access control)

Token Issuer: https://auth.cognita.io (OIDC-compliant)

Quick Reference

Purpose	Method	Path	Auth / Scope
Create Org	POST	`/orgs`	`org:admin` (system-level)
Get Org	GET	`/orgs/{orgId}`	`org:read`
Update Org	PUT	`/orgs/{orgId}`	`org:write` (org admin)
Patch Org settings	PATCH	`/orgs/{orgId}/settings`	`org:write`
List Orgs	GET	`/orgs`	`org:read` (admin)
Delete Org	DELETE	`/orgs/{orgId}`	`org:admin` (dangerous)
Set retention policy	PUT	`/orgs/{orgId}/retention`	`org:write`
Get retention policy	GET	`/orgs/{orgId}/retention`	`org:read`
Billing info	GET	`/orgs/{orgId}/billing`	`billing:read`
Update billing plan	POST	`/orgs/{orgId}/billing/plan`	`billing:write`
Suspend org	POST	`/orgs/{orgId}/suspend`	`org:admin`
Resume org	POST	`/orgs/{orgId}/resume`	`org:admin`
Manage allowed domains	POST/DELETE	`/orgs/{orgId}/domains`	`org:write`
Feature flags	GET/PUT	`/orgs/{orgId}/feature-flags`	`org:write`
Trial & limits	GET	`/orgs/{orgId}/trial`	`org:read`
Webhooks for org events	POST	`/orgs/{orgId}/webhooks`	`org:admin`
Audit logs	GET	`/orgs/{orgId}/audit-logs`	`audit:read`

Headers:

Content-Type: application/json

X-Request-ID: <uuid> (include for tracing; server echoes)

Idempotency-Key: <uuid> for mutating create operations where retries may occur (e.g., POST /orgs).

Pagination

GET /orgs and GET /orgs/{id}/audit-logs use cursor-based pagination: limit and cursor.

Custom data retention policies#

Key Use Cases#

Authentication#

Quick Reference#