> ## Documentation Index > Fetch the complete documentation index at: https://docs.usetuner.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Caller Personas > List the caller personas (language and accent) a simulated caller can use. Use a persona's `id` as `caller_persona_id` when you use Run AI-Generated Scenarios or Run Saved Scenarios. ## OpenAPI ````yaml https://api.usetuner.ai/public/openapi.json get /api/v1/workspaces/{workspace_id}/caller-personas openapi: 3.1.0 info: title: Tuner API description: >- Send calls to Tuner and manage agents, evaluation settings, simulations and workspace settings. version: 1.0.0 servers: - url: https://api.usetuner.ai security: [] tags: - name: calls description: Send call recordings and transcripts to Tuner and retrieve call details. x-group: Calls - name: workspaces description: >- Manage your workspaces, the API keys used to access them, and their PII redaction and data retention settings. x-group: Workspaces - name: simulation description: >- Run simulated calls against your agents, manage simulation profiles, and look up the caller personas and background-noise environments they can use. x-group: Simulation - name: scenarios description: Manage the test scenarios that simulated calls follow. x-group: Scenarios - name: replay-testing description: >- Replay recorded caller audio against a new version of your agent: upload or extract voice clips from real calls, then run them as replay runs. x-group: Replay Testing - name: agents description: Create, update and list the voice agents connected to your workspace. x-group: Agents - name: agent-settings description: >- Configure how Tuner evaluates an agent's calls, including evaluations, call outcomes, intents, data extraction, rules and alerts, plus the agent's SIP and outbound call configuration. x-group: Agent Settings - name: traces description: Send OpenTelemetry traces from your agent to Tuner. x-group: Traces - name: providers description: List the voice providers Tuner can connect to. x-group: Providers paths: /api/v1/workspaces/{workspace_id}/caller-personas: get: tags: - simulation summary: List Caller Personas description: >- List the caller personas (language and accent) a simulated caller can use. Use a persona's `id` as `caller_persona_id` when you use Run AI-Generated Scenarios or Run Saved Scenarios. operationId: >- list_caller_personas_api_v1_workspaces__workspace_id__caller_personas_get parameters: - name: workspace_id in: path required: true schema: type: integer description: Workspace ID. Find this in Workspace > General Settings. title: Workspace Id description: Workspace ID. Find this in Workspace > General Settings. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CallerOptionsResponse' '401': description: Missing or invalid API key. content: application/json: example: detail: Not authenticated schema: $ref: '#/components/schemas/ErrorResponse' '403': description: You do not have access to this workspace. content: application/json: example: detail: User does not have access to workspace 42 schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Workspace not found. content: application/json: example: detail: Workspace with ID 42 not found schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - Bearer: [] components: schemas: CallerOptionsResponse: properties: personas: items: $ref: '#/components/schemas/CallerPersonaResponse' type: array title: Personas description: All available caller personas. Use `id` as `caller_persona_id`. supported: additionalProperties: items: $ref: '#/components/schemas/AccentDisplay' type: array type: object title: Supported description: Accents available for each language, keyed by language name. type: object required: - personas - supported title: CallerOptionsResponse description: Available caller personas, plus the accents offered for each language. ErrorResponse: properties: detail: type: string title: Detail description: Human-readable description of what went wrong. type: object required: - detail title: ErrorResponse description: Error body returned when a request fails. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError CallerPersonaResponse: properties: id: type: integer title: Id description: >- Persona ID. Pass as `caller_persona_id` when creating a simulation run. examples: - 1 name: type: string title: Name description: Display name of the persona. examples: - English (British) language: type: string title: Language description: Language name. examples: - English language_code: type: string title: Language Code description: Language code. examples: - en accent: type: string title: Accent description: Accent identifier. examples: - British label: type: string title: Label description: Short accent label for display. examples: - UK country_code: type: string title: Country Code description: ISO 3166-1 alpha-2 country code of the accent. examples: - GB type: object required: - id - name - language - language_code - accent - label - country_code title: CallerPersonaResponse description: >- A caller persona: the language and accent a simulated caller speaks with. AccentDisplay: properties: code: type: string title: Code description: Accent identifier (same as `personas[].accent`). examples: - British label: type: string title: Label description: Short display text. examples: - UK country_code: type: string title: Country Code description: ISO 3166-1 alpha-2 country code. examples: - GB type: object required: - code - label - country_code title: AccentDisplay description: >- An accent offered for a language; ``code`` matches ``personas[].accent``. 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 securitySchemes: Bearer: type: http description: >- Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys. scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.