Get Organization
Read any organization’s record by id.
Cross-tenant read for support and operations use cases. Gated
identically to :func:list_organizations so the same JWKS
boundary keeps the endpoint off-limits to customer principals.
Callers who only need their own organization should hit the
customer-realm GET /organizations/me instead.
Args: organization_id: Clerk organization id to look up. user: Authenticated ConsoleUser (unused beyond the gate). shared_client: Shared-namespace SurrealDB client.
Returns: Organization record.
Raises: OrganizationNotFoundError: If no organization has this id.
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.
Path Parameters
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