Get My Organization
Return the authenticated caller’s own organization record.
Self-scoped replacement for the deleted
GET /organizations/{organization_id} detail endpoint. Only
reads the caller’s own organization, so the tenant-enumeration
risk that motivated PRA-362 does not apply: there is no
organization_id path parameter for a customer admin to
substitute another tenant’s id into.
Returns:
Organization record for user.organization_id.
Raises: OrganizationNotFoundError: If the caller’s organization row is missing. The bootstrap-ready gate above normally keeps this from being reachable, but the dependency is defensive.
Documentation Index
Fetch the complete documentation index at: https://docs.pragmatiks.io/llms.txt
Use this file to discover all available pages before exploring further.
Response
Successful Response
Organization record stored in shared SurrealDB namespace.
Represents a Clerk organization synced via webhooks. Stored in the shared namespace because organization data must be accessible before any organization context exists (e.g., during webhook processing).
Identity fields (frozen): organization_id: Clerk organization ID, used as SurrealDB record ID.
Metadata: name: Display name of the organization. slug: URL-friendly organization identifier from Clerk.
State (system-managed): status: Lifecycle status. bootstrap_error: Short human-readable message set when bootstrap fails; cleared on successful retry.
Inherited from PragmaModel: created_at: Creation timestamp (frozen). updated_at: Last update timestamp (mutable).
Lifecycle status of an organization.
Bootstrap states: BOOTSTRAPPING: Organization row exists, bootstrap worker has not yet finished provisioning tenant namespace resources. READY: Organization is fully provisioned and usable. BOOTSTRAP_FAILED: Bootstrap worker exhausted its retry budget. Recovery is manual during private beta: operators contact support or clear the failure via direct SurrealDB intervention.
Teardown states: DEACTIVATING: Cleanup worker is tearing down tenant resources. DELETED: Organization fully cleaned up.
bootstrapping, ready, bootstrap_failed, deactivating, deleted