read.internal.promotion_stores

The store each of these promotions is confined to, for a WHOLE page in one call — store_id: null means the whole tenant, and an id no promotion carries is simply absent from the answer. The promotions list draws its scope column with it. Internal face only.

• Surface: GET /v1/read/internal/promotion_stores · MCP tool read.internal.promotion_stores
• Auth: ★ Internal read (operator) — a tenant credential is REQUIRED; requires the promotion.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).

Params (JSON Schema)

{
  "properties": {
    "promotion_ids": {
      "type": "string"
    }
  },
  "type": "object"
}

Result (200)

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

Errors

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