---
title: "Update Music Finetune"
method: PATCH
path: "/v1/music/finetunes/{finetune_id}"
tags: ["music-finetunes"]
---

# Update Music Finetune

`PATCH /v1/music/finetunes/{finetune_id}`

Update a music finetune.

## Path parameters

- `finetune_id` string, required

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- UpdateMusicFinetuneRequestModel
  - `name` string, nullable — Updated name for the finetune.
  - `tags` string[], nullable — Replacement set of tags.
  - `primary_genre` string, nullable — Updated primary musical genre.
  - `visibility` 'private' | 'workspace', nullable — Finetune visibility. Only 'private' and 'workspace' can be set.

## Response `200`

Successful Response

- MusicFinetuneResponseModel
  - `id` string, required — Unique identifier of the finetune.
  - `name` string, required — Name of the finetune.
  - `tags` string[], required — Tags associated with the finetune.
  - `primary_genre` string, nullable — Primary musical genre of the finetune.
  - `model_id` string, required — The base music model the finetune was trained on.
  - `created_at` string, date-time, required — When the finetune was created (UTC).
  - `visibility` 'private' | 'workspace' | 'public', required
  - `created_by` 'self' | 'workspace' | 'elevenlabs', required
  - `status` 'pending' | 'in_progress' | 'completed' | 'failed' | 'blocked', required
  - `training_progress` number, required — Training progress from 0.0 to 1.0.
  - `failure_reason` 'audio_processing_failed' | 'copyright_violation' | 'training_failed'

## Other responses

- `403` — Missing permissions to manage music finetunes.
- `404` — Finetune not found.
- `422` — Validation Error

---

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