Skip to content
v0.3

read.internal.collection_admin

One collection’s sheet: definition, store scope (store_id: null = every store), counts by origin, every pin (and whether the rule reaches it too), and who references it (Used by).

  • Surface: GET /v1/read/internal/collection_admin · MCP tool read.internal.collection_admin
  • Auth: ★ Internal read (operator) — a tenant credential is REQUIRED; requires the catalog.admin.read 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).
{
"properties": {
"collection_id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"collection_id"
],
"type": "object"
}

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

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