---
title: "Read Agent"
method: GET
path: "/api/v1/agents/{agent_id_or_identifier}"
tags: ["agents"]
---

# Read Agent

`GET /api/v1/agents/{agent_id_or_identifier}`

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

Get agent by ID or identifier.

Requires authentication (JWT or API key). Returns the full agent
for the authenticated user's account only.

Supports both numeric IDs (e.g., 123) and string identifiers
(e.g., "customer-support-agent").

## Path parameters

- `agent_id_or_identifier` string, required

## Response `200`

Successful Response

- Agent

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