read.product_paths

Every product this store publishes, reduced to what a link is made of: its handle and the ltree category_path of its canonical category (null when the product is in no category). It is read.products with everything a URL does not need removed — the same published set, about 1/100th of the bytes — for a caller that walks the whole catalog to build addresses (a sitemap, a shopping feed, a channel export). Paginated; at most 1000 per page, and over the ceiling is an error, never a truncated page.

• Surface: GET /v1/read/product_paths · CLI forge read product_paths · MCP tool read.product_paths
• Auth: public (no actor; store resolves the tenant)

Params (JSON Schema)

{
  "properties": {
    "limit": {
      "default": 1000,
      "maximum": 1000,
      "minimum": 1,
      "type": "integer"
    },
    "page": {
      "default": 1,
      "maximum": 9007199254740991,
      "minimum": 1,
      "type": "integer"
    },
    "store": {
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}

Result (200)

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

Errors

validation_failed (400) · not_found (404)