Skip to main content
POST
Install a library persona into the caller's workspace

Authorizations

x-api-key
string
header
required

Path Parameters

persona_id
string<uuid>
required

Body

application/json

POST body for /v1/library/personas/{id}/install.

name_override lets callers pick a non-default name on install, typically when re-installing a template that already has a copy in the target org. When omitted, the service appends " (2)", " (3)", etc. to deduplicate against existing org personas.

name_override
string | null
Required string length: 1 - 255

Response

Successful Response

id
string<uuid>
required
organization_id
string<uuid>
required
name
string
required
description
string | null
required
is_active
boolean
required
body
string
required
traits
Traits · object
required
behavior_config
PersonaBehaviorConfig · object
required

Advanced simulation knobs attached to a persona. Stored as JSONB on personas.behavior_config; per-run overrides will reuse this shape on SimulationRun (ENG-474).

created_by
string | null
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
cloned_from_id
string<uuid> | null