---
title: "Choose Assisted Candidate"
method: POST
path: "/voices/assisted/choose"
---

# Choose Assisted Candidate

`POST /voices/assisted/choose`

## Request

- Base URL: `https://api.neuphonic.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.neuphonic.com/voices/assisted/choose`
- Auth: none declared

Record which candidate of an assisted-cloning offer the user picked: the chosen voice
gets `selected` true and the chosen sampling in its `assisted_report`, the rest of its set
`selected` false. Choosing again replaces the choice. No reference is changed.

Args:
    voice_id: The chosen candidate's `voice_id`.
    top_k: The chosen candidate's `top_k`, if it was a sampling variant.
    temperature: The chosen candidate's `temperature`, if it was a sampling variant.

Returns:
    dict: the chosen `voice_id`, and the `top_k` and `temperature` to pass with it for the
        voice to sound as its preview did.

## Query parameters

- `voice_id` string, required
- `top_k` integer
- `temperature` number
- `api_key` string, nullable
- `jwt_token` string, nullable

## Headers

- `X-API-KEY` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-10** `fe945b7061a6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/neuphonic/apis/neuphonic-api/changes/voices/assisted/choose/post.md)

---

[API](https://skmtc.dev/neuphonic/apis/neuphonic-api.md) - [All operations](https://skmtc.dev/neuphonic/apis/neuphonic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/neuphonic/apis/neuphonic-api/revisions/941fd29844c9?raw)