> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cekura.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Personality

> Create a new caller personality. Personalities define how the simulated caller speaks during runs (voice, accent, language, gender, instructions); they are then attached to evaluators.



## OpenAPI

````yaml post /test_framework/v1/personalities/
openapi: 3.1.0
info:
  title: Cekura API
  version: v1
  description: >-
    Complete API documentation for the Cekura platform. This API provides
    endpoints for testing, observing, and evaluating AI voice agents — including
    managing agents, running evaluators, defining metrics, and analyzing call
    quality.
servers:
  - url: https://api.cekura.ai
security: []
paths:
  /test_framework/v1/personalities/:
    post:
      tags:
        - test_framework
      description: Create a new caller personality
      operationId: personalities-create
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePersonality'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreatePersonality'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/CreatePersonality'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatePersonality'
          description: ''
      security:
        - api_key: []
components:
  schemas:
    CreatePersonality:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        name:
          type: string
          description: |

            Name of the personality
            Example: `"Customer Service"`
          maxLength: 255
        prompt:
          type: string
          description: >

            Prompt of the personality

            Example: `"You are a friendly and helpful customer service agent who
            is always willing to help"`
        language:
          enum:
            - af
            - ar
            - bn
            - bg
            - zh
            - cs
            - da
            - nl
            - en
            - et
            - fi
            - fr
            - de
            - el
            - gu
            - hi
            - he
            - hu
            - id
            - it
            - ja
            - kn
            - ko
            - ms
            - ml
            - mr
            - multi
            - 'no'
            - pl
            - pa
            - pt
            - ro
            - ru
            - sk
            - es
            - sv
            - th
            - tr
            - tl
            - ta
            - te
            - uk
            - vi
          type: string
          x-spec-enum-id: b822ad429c7b7fec
          description: |-

            Language of the personality


            * `af` - Afrikaans
            * `ar` - Arabic
            * `bn` - Bengali
            * `bg` - Bulgarian
            * `zh` - Chinese Simplified
            * `cs` - Czech
            * `da` - Danish
            * `nl` - Dutch
            * `en` - English
            * `et` - Estonian
            * `fi` - Finnish
            * `fr` - French
            * `de` - German
            * `el` - Greek
            * `gu` - Gujarati
            * `hi` - Hindi
            * `he` - Hebrew
            * `hu` - Hungarian
            * `id` - Indonesian
            * `it` - Italian
            * `ja` - Japanese
            * `kn` - Kannada
            * `ko` - Korean
            * `ms` - Malay
            * `ml` - Malayalam
            * `mr` - Marathi
            * `multi` - Multilingual
            * `no` - Norwegian
            * `pl` - Polish
            * `pa` - Punjabi
            * `pt` - Portuguese
            * `ro` - Romanian
            * `ru` - Russian
            * `sk` - Slovak
            * `es` - Spanish
            * `sv` - Swedish
            * `th` - Thai
            * `tr` - Turkish
            * `tl` - Tagalog
            * `ta` - Tamil
            * `te` - Telugu
            * `uk` - Ukrainian
            * `vi` - Vietnamese
        accent:
          type: string
          description: |

            Accent of the personality
            Example: `"American"`
          maxLength: 255
        background_noise:
          type: string
          description: |

            Background noise
        voice_model:
          type: string
          description: |

            Voice model name
        voice_id:
          type: string
          description: |

            Voice ID
            Example: `"TX3LPaxmHKxFdv7VOQHJ"`
        interruption_level:
          type: string
          description: |

            Interruption level
        speed:
          type: string
          description: |

            Speed of the voice
        generation_config:
          type: string
          description: |

            Generation config for Cartesia Sonic-3 voice model.
            Only valid when provider is "cartesia" and voice_model is "sonic-3".
            Supports volume and emotion
            Example: {"volume": 1.5, "emotion": "happy"}
        network_simulation:
          type: string
          description: |

            Network simulation configuration for testing network impairments.
        message_plan:
          type: string
          description: >

            Message plan configuration for idle timeout behavior.

            Supports idle_timeout_seconds (positive int) and
            idle_message_max_spoken_count (positive int).

            Example: {"idle_timeout_seconds": 15,
            "idle_message_max_spoken_count": 2}
        start_speaking_plan:
          type: string
          description: >

            Wait seconds before the bot starts speaking (float >= 0).

            Ignored if interruption_level is also set in the same request
            (preset takes precedence).

            Example: 0.7
        stop_speaking_plan:
          type:
            - string
            - 'null'
          description: >

            Stop speaking plan configuration. Controls when the bot stops
            speaking.

            Supports num_words (int >= 0), voice_seconds (float >= 0),
            backoff_seconds (float >= 0).

            Ignored if interruption_level is also set in the same request
            (preset takes precedence).

            Example: {"num_words": 3, "voice_seconds": 0.3, "backoff_seconds":
            0}
        background_sound_volume:
          type:
            - string
            - 'null'
          description: >

            Background sound volume levels (0.0 to 1.0). base sets both the base
            and normal volume; reduced sets the quieter level during bot speech.

            Example: {"base": 0.05, "reduced": 0.02}
        patronus_settings:
          oneOf:
            - {}
            - type: 'null'
          readOnly: true
        provider_agent_id:
          type: string
          readOnly: true
          description: |

            Provider agent ID
            Example: `"assistant_123"`
        end_call_enabled:
          type: boolean
          default: true
          description: |

            Whether the end call is enabled
        provider:
          enum:
            - 11labs
            - cartesia
          type: string
          x-spec-enum-id: 82a968d406c39bf3
          description: |-

            Provider of the voice


            * `11labs` - Elevenlabs
            * `cartesia` - Cartesia
      required:
        - background_noise
        - name
        - voice_model
  securitySchemes:
    api_key:
      type: apiKey
      name: X-CEKURA-API-KEY
      in: header
      description: >-
        API Key Authentication. It should be included in the header of each
        request.

````