---
title: "Create agent persona"
method: POST
path: "/api/v0/agent/personas"
tags: ["Agent Personas"]
---

# Create agent persona

`POST /api/v0/agent/personas`

Create a new agent persona for the current user.

## Request body

- AgentPersonaCreateRequest — Request body for creating an agent persona.
  - `name` string, required — The name of the persona.
  - `description` string — The description of the persona.
  - `prompt` string — The system prompt for the persona.
  - `builtin_tool_ids` string[] — Built-in tool IDs to assign to this persona.
  - `builtin_tool_configs` object — Per-builtin config, keyed by builtin tool id. Each entry is validated against the Pydantic schema registered for that tool in op_core.builtin_tool_configs. Only configurable builtins (e.g. invoke_persona) accept a config; others must be omitted.
  - `custom_tool_ids` string[] — Custom tool UUIDs to assign to this persona.
  - `knowledge_base_ids` string[] — Knowledge base UUIDs to assign to this persona.
  - `skill_ids` string[] — Skill UUIDs to preload — instruction documents the agent can read on demand via the read_skill tool.

## Response `200`

Successful Response

- AgentPersonaPostResponse — Response for creating an agent persona.
  - `id` string, uuid, required — The ID of the created 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 (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.
  - `created_at` string, date-time, required — When the persona was created.

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