Skip to content
Vitable Docs Vitable Docs Vitable Docs
API Reference

Organizations

List my organizations
GET/v1/organizations
Create organization
POST/v1/organizations
ModelsExpand Collapse
OrganizationListResponse { organizations, total }

Envelope for the caller’s organization memberships (paginated).

organizations: array of { id, idp_org_id, idp_provider, 3 more }
id: string

Prefixed organization identifier (org_<base64-encoded-uuid>).

idp_org_id: string

IdP-issued tenant id (WorkOS org id).

idp_provider: "workos" or "vitable"
  • workos - WorkOS
  • vitable - Vitable
One of the following:
"workos"
"vitable"
name: string

Human-readable organization name.

super_in: boolean

Whether this organization reads across every organization.

type: "BROKERAGE" or "TPA" or "GENERAL_AGENT" or 3 more
  • BROKERAGE - Brokerage
  • TPA - TPA
  • GENERAL_AGENT - General Agent
  • CHANNEL_PARTNER - Channel Partner
  • CONSULTING_FIRM - Consulting Firm
  • API_PLATFORM - API Platform
One of the following:
"BROKERAGE"
"TPA"
"GENERAL_AGENT"
"CHANNEL_PARTNER"
"CONSULTING_FIRM"
"API_PLATFORM"
total: number

Total number of organizations the caller belongs to.

OrganizationCreateResponse { id, idp_org_id, idp_provider, 3 more }
id: string

Prefixed organization identifier (org_<base64-encoded-uuid>).

idp_org_id: string

IdP-issued tenant id (WorkOS org id).

idp_provider: "workos" or "vitable"
  • workos - WorkOS
  • vitable - Vitable
One of the following:
"workos"
"vitable"
name: string

Human-readable organization name.

super_in: boolean

Whether this organization reads across every organization.

type: "BROKERAGE" or "TPA" or "GENERAL_AGENT" or 3 more
  • BROKERAGE - Brokerage
  • TPA - TPA
  • GENERAL_AGENT - General Agent
  • CHANNEL_PARTNER - Channel Partner
  • CONSULTING_FIRM - Consulting Firm
  • API_PLATFORM - API Platform
One of the following:
"BROKERAGE"
"TPA"
"GENERAL_AGENT"
"CHANNEL_PARTNER"
"CONSULTING_FIRM"
"API_PLATFORM"