---
title: "PUT /v1/songs/{songId}"
method: PUT
path: "/v1/songs/{songId}"
tags: ["Songs"]
---

# PUT /v1/songs/{songId}

`PUT /v1/songs/{songId}`

## Request

- Base URL: `https://api.neume.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.neume.io/v1/songs/{songId}`
- Auth: none declared

## Path parameters

- `songId` string, required

## Request body

- UpdateSongDto
  - `title` string
  - `visibility` object

## Response `200`

- GetSongDto
  - `songId` string, required: Song ID
  - `title` 'LIKE' | 'DISLIKE': User's reaction to the song
  - `stems` StemDto[], required: Stems
    - `songStemId` string, required: Stem ID
    - `stemType` string, required: Stem type
  - `image` string, required: Song image URL
  - `isInstrumental` boolean, required: Whether the song is instrumental
  - `isExplicit` boolean, required: If the song uses explicit language
  - `originalPrompt` string, required: Prompt used to generate the song
  - `description` string, required: Description
  - `lyrics` string, required: Song lyrics
  - `user` SongUser, required
    - `userId` string, required: User ID
    - `publicName` string, required: User public name
    - `firstName` string, required: User first name
    - `lastName` string, required: User last name
  - `lyricLines` SongLyricLine[], required: Lines of the lyrics with timestamp
    - `startTime` number, required: Start time of the line
    - `endTime` number, required: End time of the line
    - `content` string, required: Content of the line
    - `words` SongLyricLine[], required: Words of the line
  - `visibility` string, required: Song visibility status
  - `status` string, required: Song status
  - `ownership` string, required: Who owns the song
  - `kind` string, required: The kind of song
  - `playCount` number, required: Number of times the song has been played
  - `createdAt` string, date-time, required: Song creation date

---

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