> ## 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.

# Get Organization Status

> Return the bootstrap status of the authenticated organization.

Exempt from the bootstrap-ready gate so web and CLI clients can
poll the endpoint while the organization is still in
``BOOTSTRAPPING``. Collapses the internal lifecycle into three
states so clients do not have to learn intermediate deactivation or
deletion states:

* ``"bootstrapping"`` — bootstrap worker is still provisioning.
* ``"ready"`` — every seeded platform resource is READY.
* ``"failed"`` — the organization is in a terminal non-ready
  state and will not recover without operator intervention.

A missing organization row is also reported as ``"bootstrapping"``
because that is a transient window: the Clerk webhook has not yet
created the row, but will shortly. Clients should keep polling.

Returns:
    Public status envelope consumed by the web gate and CLI
    error wrapper.



## OpenAPI

````yaml https://api.pragmatiks.io/openapi.json get /organizations/me/status
openapi: 3.1.0
info:
  title: Pragma API
  version: 0.1.0
servers: []
security: []
paths:
  /organizations/me/status:
    get:
      tags:
        - organizations
      summary: Get Organization Status
      description: |-
        Return the bootstrap status of the authenticated organization.

        Exempt from the bootstrap-ready gate so web and CLI clients can
        poll the endpoint while the organization is still in
        ``BOOTSTRAPPING``. Collapses the internal lifecycle into three
        states so clients do not have to learn intermediate deactivation or
        deletion states:

        * ``"bootstrapping"`` — bootstrap worker is still provisioning.
        * ``"ready"`` — every seeded platform resource is READY.
        * ``"failed"`` — the organization is in a terminal non-ready
          state and will not recover without operator intervention.

        A missing organization row is also reported as ``"bootstrapping"``
        because that is a transient window: the Clerk webhook has not yet
        created the row, but will shortly. Clients should keep polling.

        Returns:
            Public status envelope consumed by the web gate and CLI
            error wrapper.
      operationId: organizations-get_organization_status
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationStatusResponse'
components:
  schemas:
    OrganizationStatusResponse:
      properties:
        status:
          type: string
          enum:
            - bootstrapping
            - ready
            - failed
          title: Status
      type: object
      required:
        - status
      title: OrganizationStatusResponse
      description: |-
        Public bootstrap status payload for the authenticated organization.

        Collapses the internal :class:`OrganizationStatus` lifecycle into
        three user-facing states the web and CLI clients can switch on
        without learning about intermediate internal states:

        * ``"bootstrapping"`` — the organization's platform stack is still
          being provisioned. Clients should keep polling and block access
          to tenant-scoped routes.
        * ``"ready"`` — every seeded platform resource has reached
          ``READY``. The client can stop polling and render the app.
        * ``"failed"`` — the organization is in a terminal non-ready state
          (``BOOTSTRAP_FAILED``, ``DEACTIVATING``, or ``DELETED``). The
          client should stop polling and display a support-contact screen.

        Deliberately minimal: no resource detail, no error text, no
        retry-after. The bootstrap gate already returns a structured 503
        envelope for the tenant-scoped routes — this endpoint exists purely
        to tell clients when to stop polling.

````