---
title: "Get agent persona"
method: GET
path: "/api/v0/agent/personas/{persona_id}"
tags: ["Agent Personas"]
---

# Get agent persona

`GET /api/v0/agent/personas/{persona_id}`

Get a single persona by UUID. 404s for personas owned by another user.

## Path parameters

- `persona_id` string, uuid, required

## Response `200`

Successful Response

- AgentPersonaGetResponse — Response for getting an agent persona.
  - `id` string, uuid, required — The ID of the persona.
  - `name` string, required — The name of the persona.
  - `description` string, required — The description of the persona.
  - `prompt` string, required — The system prompt for the persona.
  - `builtin_tool_ids` string[] — Built-in tool IDs assigned to this persona.
  - `builtin_tool_configs` object — Per-builtin config keyed by tool id. Only configurable builtins (currently invoke_persona) carry config; the dict is sparse.
  - `custom_tool_ids` string[] — Custom tool UUIDs assigned to this persona.
  - `knowledge_base_ids` string[] — Knowledge base UUIDs assigned to this persona.
  - `skill_ids` string[] — Skill UUIDs preloaded by this persona — instruction documents the agent can read on demand via the read_skill tool.
  - `created_at` string, date-time, required — When the persona was created.
  - `updated_at` string, date-time, required — When the persona was last updated.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/outerport/apis/outerport-api.md) · [All operations](https://skmtc.dev/outerport/apis/outerport-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/outerport/outerport-api/revisions/f565b46daaea/schema)