Sign in
Agent Personas

Create agent persona

Create a new agent persona for the current user.

post/api/v0/agent/personas

Request body

namestring required

The name of the persona.

descriptionstring

The description of the persona.

promptstring

The system prompt for the persona.

builtin_tool_idsstring[]

Built-in tool IDs to assign to this persona.

builtin_tool_configsobject

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_idsstring[]

Custom tool UUIDs to assign to this persona.

knowledge_base_idsstring[]

Knowledge base UUIDs to assign to this persona.

skill_idsstring[]

Skill UUIDs to preload — instruction documents the agent can read on demand via the read_skill tool.

Response

Successful Response

idstring uuid required

The ID of the created persona.

namestring required

The name of the persona.

descriptionstring required

The description of the persona.

promptstring required

The system prompt for the persona.

builtin_tool_idsstring[]

Built-in tool IDs assigned to this persona.

builtin_tool_configsobject

Per-builtin config keyed by tool id (sparse).

custom_tool_idsstring[]

Custom tool UUIDs assigned to this persona.

knowledge_base_idsstring[]

Knowledge base UUIDs assigned to this persona.

skill_idsstring[]

Skill UUIDs preloaded by this persona.

created_atstring date-time required

When the persona was created.

Changes