---
title: "Get Agent"
method: GET
path: "/api/agents/{agent_id}"
tags: ["agents"]
---

# Get Agent

`GET /api/agents/{agent_id}`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/agents/{agent_id}`
- Auth: none declared

Get detail for a single agent.

TOS-3663 (decision U3): the payload shape depends on the caller's
relationship. Owners (myself/built) get the full ``AgentResponse``;
everyone else gets it with ``OWNER_ONLY_AGENT_FIELDS`` (Mind, behavior,
credential, and finance configuration) OMITTED from the JSON entirely,
not nulled. Serialized through ``_agent_payload`` rather than a FastAPI
response_model so the omitted keys are genuinely absent. TOS-4945 layers
the owner's capabilities/reputation disclosure switches on top of that.

``?as=connected|hirer|public`` (TOS-4945) lets an owner preview their own
identity's payload as another viewer would see it. One implementation of
the omission/disclosure rule serves both the real and the previewed
payload - the query param only substitutes the relationship BEFORE
``_agent_payload`` runs. Owner-only: rejected with 422 for a caller whose
real relationship is not already myself/built.

## Path parameters

- `agent_id` string, uuid, required

## Query parameters

- `as` string, nullable: Owner-only preview: render the payload as connected/hirer/public would see it.

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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