GET /v1/admin/tenants

Family: Platform admin · Operation ID: list_tenants

Access

Private platform operator API. Requires x-reacher-secret on the internal backend and explicit operator authorization. Workspace API keys cannot call this route.

Open platform operations

Parameters

[
  {
    "in": "query",
    "name": "status",
    "required": false,
    "schema": {
      "type": "string"
    }
  },
  {
    "in": "query",
    "name": "limit",
    "required": false,
    "schema": {
      "type": "integer"
    }
  },
  {
    "in": "query",
    "name": "offset",
    "required": false,
    "schema": {
      "type": "integer"
    }
  }
]

Responses

200

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AdminTenantList"
      }
    }
  },
  "description": "Tenant list"
}

default

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ErrorEnvelope"
      }
    }
  },
  "description": "Request error"
}

Download the full OpenAPI contract