read.internal.stores

The tenant’s stores (id, name, handle, host, theme_key) — publish/unpublish targets. host is the public URL; theme_key names the storefront theme the store wears. notification_sender_name and notification_reply_to are the store’s own sender identity for transactional messages, null when it uses the instance’s. storefront_enabled is false when the store has no public page (the storefront answers 404 for it, while the port and the admin keep working). Internal face only.

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