Skip to main content
GET
Get My Organization

Response

Successful Response

Organization record persisted in the shared platform 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 the 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 recording the latest bootstrap failure; cleared when bootstrap completes. bootstrap_deadline_at: Time after which an organization still bootstrapping is moved to bootstrap_failed. last_published_at: When the organization last started publishing a provider version; written in the publish transaction so a concurrent teardown conflicts with it.

Inherited from PragmaModel: created_at: Creation timestamp (frozen). updated_at: Last update timestamp (mutable).

organization_id
string
required
name
string
required
slug
string
required
bootstrap_deadline_at
string<date-time>
required
created_at
string<date-time>
updated_at
string<date-time>
status
enum<string>
default:bootstrapping

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: The bootstrap deadline passed before setup finished. Recovery is manual: operators contact support or clear the failure via direct platform intervention.

Teardown states: DEACTIVATING: Cleanup worker is tearing down tenant resources. DELETED: Organization fully cleaned up.

Available options:
bootstrapping,
ready,
bootstrap_failed,
deactivating,
deleted
bootstrap_error
string | null
last_published_at
string<date-time> | null