read.internal.clusters_admin

The customer clusters of this tenant, with member counts split by origin (by rule · pinned) and the rule itself. INTERNAL only — a cluster is a claim about people and never reaches the storefront.

• Surface: GET /v1/read/internal/clusters_admin · MCP tool read.internal.clusters_admin
• Auth: ★ Internal read (operator) — a tenant credential is REQUIRED; requires the customer.admin.write scope. The tenant is resolved from the CALLER’s identity, never from store. Personal fields come back MASKED for an actor without pii.read (the shape is unchanged).

Params (JSON Schema)

{
  "properties": {
    "limit": {
      "default": 24,
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "page": {
      "default": 1,
      "maximum": 9007199254740991,
      "minimum": 1,
      "type": "integer"
    },
    "q": {
      "minLength": 1,
      "type": "string"
    },
    "sort": {
      "enum": [
        "name_asc",
        "name_desc",
        "newest",
        "oldest"
      ],
      "type": "string"
    },
    "state": {
      "default": "active",
      "enum": [
        "all",
        "active",
        "archived"
      ],
      "type": "string"
    }
  },
  "type": "object"
}

Result (200)

Open (unknown) — this capability does not declare an output schema.

Errors

validation_failed (400) · not_found (404) · unauthorized (401) · forbidden (403)