Skip to main content
GET
/
organizations
/
{organization_id}
Get Organization
curl --request GET \
  --url https://api.example.com/organizations/{organization_id}
{
  "organization_id": "<string>",
  "name": "<string>",
  "slug": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "status": "active",
  "main_agent_resource_id": "<string>"
}

Path Parameters

​
organization_id
string
required

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 (active, deactivating, deleted).

Agent routing: main_agent_resource_id: SurrealDB resource ID of the organization's main conversation agent, used as the entry point for chat routing.

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

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

Lifecycle status of an organization.

Available options:
active,
deactivating,
deleted
​
main_agent_resource_id
string | null