---
title: "Returns one agent of the authenticated account."
method: GET
path: "/api/agents/{uuid}"
tags: ["agents"]
---

# Returns one agent of the authenticated account.

`GET /api/agents/{uuid}`

## Request

- Base URL: `https://api.pricklymails.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pricklymails.com/api/agents/{uuid}`
- Auth: HTTP bearer

## Path parameters

- `uuid` string, required

## Response `200`

The requested agent.

- AgentResponse: Metadata of an agent, returned when creating, listing, reading or revoking agents.
  - `created_at` string, required: RFC 3339 creation timestamp.
  - `description` string, nullable: Description of the agent, omitted when none was set.
  - `is_active` boolean, required: Whether the agent can currently authenticate.
  - `name` string, required: Display name of the agent.
  - `scopes` string[], required: Scopes granted to the agent.
  - `status` string, required: Status of the agent: `"active"` or `"revoked"`.
  - `updated_at` string, required: RFC 3339 timestamp of the last change.
  - `uuid` string, required: Public UUID of the agent.

## Other responses

- `400`: Malformed uuid.
- `401`: Missing or invalid JWT.
- `404`: No agent with that uuid owned by the caller.

---

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