read.suggest

Autocomplete: top-N products (name/handle/price/image) by prefix/trigram + matching categories the store serves (an inactive category is not offered — its page 404s).

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

Params (JSON Schema)

{
  "properties": {
    "limit": {
      "default": 8,
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "q": {
      "minLength": 1,
      "type": "string"
    },
    "store": {
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "q"
  ],
  "type": "object"
}

Result (200)

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

Errors

validation_failed (400) · not_found (404)