resolve

Resolve Uri

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)

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

Query parameters

uristring required

Agent URI path to resolve (e.g., 'my-assistant')

Headers

X-Access-Passwordstring nullable

Response

Successful Response

AgentPublicResolve required

Changes

No recorded changes to this operation across all 1 revision of this API.