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

# Resolve persona capabilities

> Resolve the selected provider, model, voice, and language combination. Status and reason values are authoritative for authoring, Preview, and voice execution.



## OpenAPI

````yaml openapi.json GET /v1/persona-capabilities
openapi: 3.1.0
info:
  title: Egma Platform API
  version: 1.0.0
  description: >-
    The customer-facing HTTP interface used by Egma's web app, CLI, and outside
    clients.
servers:
  - url: https://app.egma.ai
security: []
paths:
  /v1/persona-capabilities:
    get:
      tags:
        - Personas
      summary: Resolve persona capabilities
      description: >-
        Resolve the selected provider, model, voice, and language combination.
        Status and reason values are authoritative for authoring, Preview, and
        voice execution.
      operationId: getPersonaCapabilities
      parameters:
        - name: projectId
          in: query
          required: false
          schema:
            type: string
            minLength: 1
        - name: ttsProvider
          in: query
          required: true
          schema:
            type: string
        - name: ttsModel
          in: query
          required: true
          schema:
            type: string
        - name: sttProvider
          in: query
          required: true
          schema:
            type: string
        - name: sttModel
          in: query
          required: true
          schema:
            type: string
        - name: language
          in: query
          required: false
          schema:
            type: string
        - name: voiceId
          in: query
          required: false
          schema:
            type: string
        - name: refresh
          in: query
          required: false
          schema:
            type: boolean
      responses:
        '200':
          description: Capabilities for the selected combination.
          content:
            application/json:
              schema:
                type: object
                properties:
                  voices:
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - supported
                          - fixed
                          - unsupported
                          - unknown
                      reason:
                        type: string
                      choices:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            source:
                              type: string
                              enum:
                                - standard
                                - account
                            presentation:
                              type: string
                              enum:
                                - male
                                - female
                                - neutral
                                - unknown
                            languages:
                              type: array
                              items:
                                type: string
                            accents:
                              type: array
                              items:
                                type: string
                          required:
                            - id
                            - name
                            - source
                            - presentation
                            - languages
                            - accents
                          additionalProperties: false
                      value:
                        type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                          source:
                            type: string
                            enum:
                              - standard
                              - account
                          presentation:
                            type: string
                            enum:
                              - male
                              - female
                              - neutral
                              - unknown
                          languages:
                            type: array
                            items:
                              type: string
                          accents:
                            type: array
                            items:
                              type: string
                        required:
                          - id
                          - name
                          - source
                          - presentation
                          - languages
                          - accents
                        additionalProperties: false
                      range:
                        type: object
                        properties:
                          minimum:
                            type: number
                          maximum:
                            type: number
                          step:
                            type: number
                        required:
                          - minimum
                          - maximum
                          - step
                        additionalProperties: false
                    required:
                      - status
                    additionalProperties: false
                  language:
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - supported
                          - fixed
                          - unsupported
                          - unknown
                      reason:
                        type: string
                      choices:
                        type: array
                        items:
                          type: string
                      value:
                        type: string
                      range:
                        type: object
                        properties:
                          minimum:
                            type: number
                          maximum:
                            type: number
                          step:
                            type: number
                        required:
                          - minimum
                          - maximum
                          - step
                        additionalProperties: false
                    required:
                      - status
                    additionalProperties: false
                  accent:
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - supported
                          - fixed
                          - unsupported
                          - unknown
                      reason:
                        type: string
                      choices:
                        type: array
                        items:
                          type: string
                      value:
                        type: string
                      range:
                        type: object
                        properties:
                          minimum:
                            type: number
                          maximum:
                            type: number
                          step:
                            type: number
                        required:
                          - minimum
                          - maximum
                          - step
                        additionalProperties: false
                    required:
                      - status
                    additionalProperties: false
                  emotion:
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - supported
                          - fixed
                          - unsupported
                          - unknown
                      reason:
                        type: string
                      choices:
                        type: array
                        items:
                          type: string
                      value:
                        type: string
                      range:
                        type: object
                        properties:
                          minimum:
                            type: number
                          maximum:
                            type: number
                          step:
                            type: number
                        required:
                          - minimum
                          - maximum
                          - step
                        additionalProperties: false
                    required:
                      - status
                    additionalProperties: false
                  speed:
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - supported
                          - fixed
                          - unsupported
                          - unknown
                      reason:
                        type: string
                      choices:
                        type: array
                        items:
                          type: number
                      value:
                        type: number
                      range:
                        type: object
                        properties:
                          minimum:
                            type: number
                          maximum:
                            type: number
                          step:
                            type: number
                        required:
                          - minimum
                          - maximum
                          - step
                        additionalProperties: false
                    required:
                      - status
                    additionalProperties: false
                  speechVolume:
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - supported
                          - fixed
                          - unsupported
                          - unknown
                      reason:
                        type: string
                      choices:
                        type: array
                        items:
                          type: number
                      value:
                        type: number
                      range:
                        type: object
                        properties:
                          minimum:
                            type: number
                          maximum:
                            type: number
                          step:
                            type: number
                        required:
                          - minimum
                          - maximum
                          - step
                        additionalProperties: false
                    required:
                      - status
                    additionalProperties: false
                required:
                  - voices
                  - language
                  - accent
                  - emotion
                  - speed
                  - speechVolume
                additionalProperties: false
        '400':
          description: The request was refused.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Refusal'
        '401':
          description: The request was refused.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Refusal'
        '403':
          description: The request was refused.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Refusal'
        '404':
          description: The request was refused.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Refusal'
        '422':
          description: The request was refused.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Refusal'
        '429':
          description: The request rate limit was reached.
          headers:
            Retry-After:
              description: Seconds to wait before trying again.
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Refusal'
      security:
        - bearerAuth: []
        - sessionCookie: []
components:
  schemas:
    Refusal:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        details:
          type: object
          additionalProperties: true
      required:
        - error
        - message
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: An Egma API key.
    sessionCookie:
      type: apiKey
      in: cookie
      name: egma.session_token
      description: >-
        The browser session cookie issued by Egma. HTTPS deployments add the
        standard __Secure- prefix.

````