Skip to main content
POST
Add a persona to the global library (Feather staff only)

Authorizations

x-api-key
string
header
required

Body

application/json

Create a library persona (Feather-staff only at the router layer).

name
string
required
Required string length: 1 - 255
body
string
required
Minimum string length: 1
description
string | null
traits
Traits · object
behavior_config
PersonaBehaviorConfig · object

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

tags
string[]
Maximum array length: 20

Response

Successful Response

Library persona payload returned by /v1/library/personas routes.

id
string<uuid>
required
name
string
required
description
string | null
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).

tags
string[]
required
created_by
string | null
required
created_at
string<date-time>
required
updated_at
string<date-time>
required