---
title: "Returns voice suggestions for the source characters in a target language. Advisory only - the UI may override any suggestion when finally calling the import endpoint. Suggestions never duplicate voices across distinct source characters unless the source characters already shared the same voice in the original story."
method: POST
path: "/api/stories/import/voices"
tags: ["StoryImports"]
---

# Returns voice suggestions for the source characters in a target language. Advisory only - the UI may override any suggestion when finally calling the import endpoint. Suggestions never duplicate voices across distinct source characters unless the source characters already shared the same voice in the original story.

`POST /api/stories/import/voices`

## Request

- Base URL: `https://api.wearelearning.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wearelearning.io/api/stories/import/voices`
- Auth: OAuth 2
  - Implicit: `https://login.wearelearning.io/authorize?audience=https://api.wearelearning.io`

## Request body

- StoryImportVoicesRequestDto
  - `importToken` string, required
  - `targetLanguageCode` string, required
  - `characterMappings` object, nullable

## Response `200`

OK

- StoryImportVoicesDto
  - `characterVoiceSuggestions` CharacterVoiceSuggestionDto[], required
    - `sourceCharacterId` string, required
    - `suggestedVoiceShortName` string, nullable
    - `voice` VoiceInfoDto
      - `shortName` string, required
      - `displayName` string, required
      - `locale` string, required
      - `gender` 'Female' | 'Male', required
    - `sourceVoice` VoiceInfoDto
      - `shortName` string, required
      - `displayName` string, required
      - `locale` string, required
      - `gender` 'Female' | 'Male', required
    - `reason` string, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Content

---

[API](https://skmtc.dev/wearelearning/apis/we-are-learning-api.md) - [All operations](https://skmtc.dev/wearelearning/apis/we-are-learning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wearelearning/apis/we-are-learning-api/revisions/e2ca5265db77?raw)