---
title: "Resolve Uri"
method: GET
path: "/api/v1/resolve"
tags: ["resolve"]
---

# Resolve Uri

`GET /api/v1/resolve`

## 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`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-AUTH-TOKEN`

Resolve a URI to its corresponding agent.

**URI Format:** The agent's URI path (e.g., `my-assistant`)

**Example:** `/api/v1/resolve?uri=my-assistant`

**Access Control:**
- PUBLIC agents: No authentication required
- PASSWORD_PROTECTED agents: Requires `X-Access-Password` header
- PRIVATE agents: Requires user authentication (Bearer token or API key)

**Authentication Methods:**
- Bearer token: `Authorization: Bearer <jwt_token>`
- API key: `X-AUTH-TOKEN: <api_key>`

**Password-Protected Access:**
- Header: `X-Access-Password: <password>`

**Theme resolution:** an agent with no explicitly-assigned theme inherits
the account's default chat theme (the one marked "Set as default"). The
inherited theme is returned in `chat_theme`; the agent's own
`chat_theme_id` stays `null` (it is inheriting, not owning). With no
account default, `chat_theme` is `null` and the client uses its built-in
default.

Returns:
    Agent object if found and access is granted

Raises:
    404: Agent not found
    401: Authentication required (for password-protected or private agents)
    403: Access denied (wrong password or insufficient permissions)

## Query parameters

- `uri` string, required: Agent URI path to resolve (e.g., 'my-assistant')

## Headers

- `X-Access-Password` string, nullable

## Response `200`

Successful Response

- AgentPublicResolve

## 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)