---
updatedAt: 2026-08-21T16:12:58.000Z
agentTools:
  projectIndex: https://docs.rackspace.com/llms.txt
---

# List the caller's organizations

Returns the Auth0 organizations the authenticated user is a member of.
The organizer adds a `namespace` entry to each organization's `metadata`
(the Auth0 organization ID normalized to its Kubernetes namespace).


# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "RackAI API",
    "description": "REST API for RackAI Custom Resources managed by the `rackai.rackspace.com` operator.\n\nMost requests are routed through the Kubernetes API server and authenticated\nwith a bearer token (service-account token or kubeconfig credential).\n\nOrganization management is the exception: tenants have no RBAC to edit the\n`Organization` custom resource directly, so those operations are served by the\norganizer service behind the Front Proxy and authenticated with an Auth0 OIDC\ntoken. See the **Organization** tag.\n\n**Base path:** `/apis/rackai.rackspace.com/v1alpha1`\n",
    "version": "v1alpha1",
    "contact": {
      "name": "Rackspace Spot Platform Engineering"
    }
  },
  "servers": [
    {
      "url": "https://{fqdn}/apis/rackai.rackspace.com/v1alpha1",
      "description": "API Server",
      "variables": {
        "fqdn": {
          "default": "localhost:6443",
          "description": "Fully-qualified domain name (and optional port) of the Front Proxy in front of the Kubernetes API server"
        }
      }
    }
  ],
  "security": [
    {
      "BearerToken": []
    }
  ],
  "tags": [
    {
      "name": "Organization",
      "description": "Organization represents a tenant in the RackAI platform.\nThe controller provisions a dedicated Kubernetes namespace and RBAC policies\nfor each Organization, isolating its workloads (Models, ModelClasses,\nModelDeployments, RegistryCredentials, LoRAAdapters, Datasets,\nFineTuningJobs) from other tenants. The resulting namespace is reported in\nstatus.namespace."
    }
  ],
  "paths": {
    "/apis/auth.rackai.io/v1/organizations": {
      "servers": [
        {
          "url": "https://{fqdn}",
          "description": "Front Proxy (routes /apis/auth.rackai.io to the organizer service).",
          "variables": {
            "fqdn": {
              "default": "localhost:6443",
              "description": "Fully-qualified domain name (and optional port) of the Front Proxy."
            }
          }
        }
      ],
      "get": {
        "tags": [
          "Organization"
        ],
        "summary": "List the caller's organizations",
        "description": "Returns the Auth0 organizations the authenticated user is a member of.\nThe organizer adds a `namespace` entry to each organization's `metadata`\n(the Auth0 organization ID normalized to its Kubernetes namespace).\n",
        "operationId": "listMyOrganizations",
        "security": [
          {
            "Auth0Bearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Auth0OrganizationList"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerToken": {
        "type": "http",
        "scheme": "bearer",
        "description": "Bearer token for the Kubernetes-extension API surface\n(`/apis/rackai.rackspace.com/v1alpha1/...`). Pass as\n`Authorization: Bearer <token>`.\n\nNote: for paths reached through the Front Proxy, the credential\npresented is an Auth0-issued OIDC bearer that the proxy validates\nand forwards to the upstream apiserver (which validates the same\ntoken via OIDC). A Kubernetes service-account token or kubeconfig\ncredential is what's typically used when hitting the apiserver\ndirectly (e.g. from inside the cluster).\n"
      },
      "Auth0Bearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "Auth0-issued OIDC access token, used by the organizer service\n(`/apis/auth.rackai.io/v1/...`). Pass as `Authorization: Bearer <token>`.\n"
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Bad Request — the request body or parameters are invalid."
      },
      "Unauthorized": {
        "description": "Unauthorized — no or invalid bearer token provided."
      }
    },
    "schemas": {
      "Auth0Organization": {
        "type": "object",
        "description": "An Auth0 organization record as returned by the organizer.",
        "properties": {
          "id": {
            "type": "string",
            "example": "org_xxxxxxxxxxxxxxxx"
          },
          "name": {
            "type": "string",
            "example": "acme-corp"
          },
          "display_name": {
            "type": "string",
            "example": "Acme Corp"
          },
          "branding": {
            "type": "object",
            "properties": {
              "logo_url": {
                "type": "string",
                "format": "uri"
              }
            }
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Arbitrary string metadata. In list responses the organizer injects a\n`namespace` key — the organization's Kubernetes namespace.\n",
            "example": {
              "namespace": "org-xxxxxxxxxxxxxxxx"
            }
          }
        }
      },
      "Auth0OrganizationList": {
        "type": "object",
        "description": "A page of Auth0 organizations. Pagination fields mirror the upstream\nAuth0 management SDK; additional pagination fields may appear.\n",
        "properties": {
          "organizations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Auth0Organization"
            }
          },
          "start": {
            "type": "integer",
            "description": "Zero-based index of the first item on this page.",
            "example": 0
          },
          "limit": {
            "type": "integer",
            "description": "Maximum number of items requested for this page.",
            "example": 50
          },
          "length": {
            "type": "integer",
            "description": "Number of items returned on this page.",
            "example": 1
          },
          "total": {
            "type": "integer",
            "example": 1
          },
          "next": {
            "type": "string",
            "description": "Opaque cursor for the next page, when present."
          }
        }
      }
    }
  }
}
```