read.store.by_host

Resolve a request hostname to the store that serves it, or null when no store claims it. The directory key is derived from each store’s public URL: scheme, path, query and fragment are dropped, the host is lowercased and IDN-punycoded, and the scheme’s default port is removed (so “https://loja.com” and “https://loja.com:443” are the same address, while “http://localhost:3001” and “http://localhost:3002” are two). Matching tries the exact host WITH its port first, then falls back to the bare host — so a store published on a port is only reachable on that port, while a proxy forwarding “loja.com:443” still finds the store registered as “loja.com”. A hostname is unique across ALL tenants. Public and actorless: it returns only the store id.

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

Params (JSON Schema)

{
  "properties": {
    "host": {
      "description": "The request Host header, e.g. \"loja.example.com\" or \"localhost:3001\". Case-insensitive; the port is significant (see the matching rule).",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "host"
  ],
  "type": "object"
}

Result (200)

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

Errors

validation_failed (400) · not_found (404)