v50

OpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-08-01147180956.9 KB
System

Backend identity

Return this backend's self-describing identity.

Unauthenticated and dependency-free so any client (an MCP server, the CLI, an agent) can read which backend it is bound to — local vs. a remote install — and label its responses accordingly.

get/instance

Response

Successful Response

backend'local' | 'remote' required

Operator-declared backend locality (server.backend): 'local' for a self-hosted install on the operator's own machine/network, 'remote' for a hosted install run elsewhere. A hint, not an authorization signal; defaults to 'local'.

canonical_base_urlstring required

The instance's own canonical base URL (auth.canonical_base_url), with any userinfo stripped; '' if unset.

hoststring required

Host (and port, when the canonical base URL declares one) parsed from canonical_base_url; '' if unset or unparseable.

instance_idstring nullable

Opaque digest derived from the telemetry instance id — stable per install, but not the telemetry id itself. Null when telemetry has not resolved an id (e.g. telemetry disabled).