Agent Personas

Update agent persona

Update one or more fields on a persona.

put/api/v0/agent/personas/{persona_id}

Path parameters

persona_idstring uuid required

namestring nullable

New name.

descriptionstring nullable

New description.

promptstring nullable

New system prompt.

builtin_tool_idsstring[] nullable

builtin_tool_configsobject nullable

Replace the per-builtin config dict wholesale. None means leave it alone; an empty dict clears all per-builtin config.

custom_tool_idsstring[] nullable

knowledge_base_idsstring[] nullable

skill_idsstring[] nullable

New full skill list (replaces existing). None means leave the existing associations alone; an empty list means clear them.

Successful Response

idstring uuid required

The ID of the 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. Only configurable builtins (currently invoke_persona) carry config; the dict is 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 — instruction documents the agent can read on demand via the read_skill tool.

created_atstring date-time required

When the persona was created.

updated_atstring date-time required

When the persona was last updated.

No recorded changes to this endpoint across all 1 revision of this API.