Skip to content
v0.3

read.internal.catalog_labels

Resolve product ids and sku ids to the names an operator reads (product title, and the variant name for a sku). Draft-inclusive and store-blind. Unknown ids are simply absent from the answer — a lookup, not a validation. Internal face only.

  • Surface: GET /v1/read/internal/catalog_labels · MCP tool read.internal.catalog_labels
  • 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": {
"product_ids": {
"type": "string"
},
"sku_ids": {
"type": "string"
}
},
"type": "object"
}

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

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