---
title: "Resolve Qr Slug"
method: GET
path: "/api/v1/resolve/qr/{slug}"
tags: ["resolve"]
---

# Resolve Qr Slug

`GET /api/v1/resolve/qr/{slug}`

## Request

- Base URL: `https://api.gnosari.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gnosari.com/api/v1/resolve/qr/{slug}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-AUTH-TOKEN`

Legacy alias for printed QR codes -- resolves from ``agent_link``.

**Public endpoint -- no authentication required.**

Physical QR artifacts encode ``/q/{slug}`` -> ``/resolve/qr/{slug}`` and
cannot be reprinted, so this alias keeps them working by resolving the
backfilled slug from ``agent_link`` with the SAME response shape and the
same boundary guard as ``/resolve/l/{slug}``.

## Path parameters

- `slug` string, required

## Response `200`

Successful Response

- LinkResolveResponse: Public resolve payload for ``GET /resolve/l/{slug}``. Distinct from ``AgentLinkRead`` (the authed/MCP CRUD shape) and from the legacy ``QrResolveResponse``. The embed page (Phase 8) consumes this shape verbatim so it needs NO agent-config lookup of its own: ``greeting`` is resolved server-side (``link.greeting`` else the agent's ``chat_ui`` greeting) and ``theme`` carries the post-3-tier effective branding.
  - `available` boolean, required
  - `agent` LinkResolveAgent: Public-safe agent data carried on a resolve response. Only the fields a renderer needs — no private agent config ever leaks.
    - `uri` string, nullable
    - `name` string, nullable
    - `avatar` string, nullable
  - `presentation` string, required
  - `topic` string, nullable
  - `caption` string, nullable
  - `greeting` string, nullable
  - `theme` ChatThemeMinimal: Minimal schema for embedding in agent responses. Contains only essential fields to avoid circular references.
    - `id` integer, required
    - `name` string, required
    - `identifier` string, nullable
    - `configuration` object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gnosari/apis/gnosari-api.md) · [All operations](https://skmtc.dev/gnosari/apis/gnosari-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gnosari/apis/gnosari-api/revisions/f299cf53ae5f?raw)