---
title: "Voice Settings"
method: POST
path: "/api/v2/voices/settings"
tags: ["voices"]
---

# Voice Settings

`POST /api/v2/voices/settings`

## Headers

- `x-csrf-token` string
- `api-key` string

## Cookies

- `session_id` string

## Request body

- VoiceSettingsUpdate
  - `voice_id` string, uuid4, required
  - `accent_id` string, uuid4
  - `semitones_correction` number
  - `narration_style_id` string, uuid4

## Response `200`

Successful Response

- VoicePublic
  - `id` string, uuid4, required
  - `owner_id` string, uuid4, required
  - `name` string, required
  - `slug` string, required
  - `visibility` 'public' | 'paid' | 'private' | 'kids', required — An enumeration.
  - `species` 'human' | 'animal' | 'other' — An enumeration.
  - `artist` string
  - `verified_artist` boolean
  - `gender` 'male' | 'female' — An enumeration.
  - `pitch` number
  - `age_group` 'child' | 'young' | 'adult' | 'senior' — An enumeration.
  - `pitch_group` 'low' | 'mid' | 'high' — An enumeration.
  - `nationality` string
  - `image_url` string
  - `thumbnail_url` string
  - `description` string
  - `rating` integer, required
  - `active` boolean, required
  - `created_at` string, date-time, required
  - `favorite` boolean
  - `available` boolean
  - `accents` AccentPublic[], required
    - `id` string, uuid4, required
    - `is_default` boolean, required
    - `native` boolean, required
    - `info` AccentInfoCore, required
      - `name` string, required
      - `short_name` string, required
      - `locale` string, required
    - `tiers` SubscriptionTierCore[], required
      - `name` string, required
    - `available` boolean
    - `settings` AccentSettingsPublic
      - `favorite` boolean
      - `semitones_correction` number
  - `narration_styles` NarrationStylePublic[], required
    - `id` string, uuid4, required
    - `is_default` boolean, required
    - `info` NarrationStyleInfoCore, required
      - `name` string, required
    - `settings` NarrationStyleSettingPublic
      - `favorite` boolean
  - `tiers` SubscriptionTierCore[], required
    - `name` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/respeecher/apis/voice-markertplace-api.md) · [All operations](https://skmtc.net/respeecher/apis/voice-markertplace-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/respeecher/voice-markertplace-api/versions/dea31af89a85/schema)