> ## Documentation Index > Fetch the complete documentation index at: https://doc.featherhq.com/llms.txt > Use this file to discover all available pages before exploring further. # Install a library persona into the caller's workspace ## OpenAPI ````yaml /api-reference/openapi.json post /v1/library/personas/{persona_id}/install openapi: 3.1.0 info: title: Feather API description: >- Unified customer experience platform API. Manages identity, conversations, memory, agents, procedures, policies, model routing, knowledge bases, integrations, and runtime execution. version: 1.21.0 servers: - url: https://api-sandbox.featherhq.com description: Sandbox - url: http://localhost:8000 description: Local dev security: [] paths: /v1/library/personas/{persona_id}/install: post: tags: - library summary: Install a library persona into the caller's workspace operationId: installLibraryPersona parameters: - name: persona_id in: path required: true schema: type: string format: uuid title: Persona Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/InstallPersonaRequest' responses: '201': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PersonaResponse' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: InstallPersonaRequest: properties: name_override: anyOf: - type: string maxLength: 255 minLength: 1 - type: 'null' title: Name Override additionalProperties: false type: object title: InstallPersonaRequest description: |- 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. PersonaResponse: properties: id: type: string format: uuid title: Id organization_id: type: string format: uuid title: Organization Id name: type: string title: Name description: anyOf: - type: string - type: 'null' title: Description is_active: type: boolean title: Is Active body: type: string title: Body traits: additionalProperties: true type: object title: Traits behavior_config: $ref: '#/components/schemas/PersonaBehaviorConfig' cloned_from_id: anyOf: - type: string format: uuid - type: 'null' title: Cloned From Id created_by: anyOf: - type: string - type: 'null' title: Created By created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At type: object required: - id - organization_id - name - description - is_active - body - traits - behavior_config - created_by - created_at - updated_at title: PersonaResponse ErrorResponse: properties: error: type: string title: Error message: type: string title: Message type: object required: - error - message title: ErrorResponse description: Standard error response returned by all API error handlers. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PersonaBehaviorConfig: properties: first_speaker: type: string enum: - persona - agent title: First Speaker default: agent cut_in: $ref: '#/components/schemas/PersonaCutInConfig' language: anyOf: - type: string maxLength: 20 - type: 'null' title: Language background_noise: type: string enum: - none - office - cafe - city - keyboard_typing title: Background Noise default: none background_noise_volume: type: number maximum: 1 minimum: 0 title: Background Noise Volume default: 0.3 wait_seconds: type: number maximum: 30 minimum: 0 title: Wait Seconds default: 0 yield_on_overlap: $ref: '#/components/schemas/PersonaYieldConfig' interruption_mode: type: string enum: - 'off' - low - medium - high title: Interruption Mode default: 'off' backchannel_style: type: string enum: - neutral - impatient - polite title: Backchannel Style default: neutral backchannel_overrides: anyOf: - items: type: string type: array - type: 'null' title: Backchannel Overrides reaction_pause_ms_min: type: integer maximum: 5000 minimum: 0 title: Reaction Pause Ms Min default: 200 reaction_pause_ms_max: type: integer maximum: 5000 minimum: 0 title: Reaction Pause Ms Max default: 500 additionalProperties: false type: object title: PersonaBehaviorConfig description: |- 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). ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError PersonaCutInConfig: properties: min_words: type: integer maximum: 20 minimum: 0 title: Min Words default: 3 min_duration_ms: type: integer maximum: 10000 minimum: 0 title: Min Duration Ms default: 300 backoff_ms: type: integer maximum: 10000 minimum: 0 title: Backoff Ms default: 1000 additionalProperties: false type: object title: PersonaCutInConfig description: |- Persona-as-interrupter — when the agent is speaking, when does the persona cut in? Mirrors voice ``interruption_*`` knobs on ``VoicePipelineConfig``. PersonaYieldConfig: properties: after_words: anyOf: - type: integer maximum: 20 minimum: 1 - type: 'null' title: After Words default: 2 after_seconds: anyOf: - type: number maximum: 10 minimum: 0.1 - type: 'null' title: After Seconds default: 0.5 additionalProperties: false type: object title: PersonaYieldConfig description: |- Persona-as-yielder — when the persona is speaking and the agent starts talking, when does the persona stop? Whichever threshold fires first triggers the yield. ``None`` disables that dimension. securitySchemes: APIKeyHeader: type: apiKey in: header name: x-api-key ````