1. API
  2. Songs

songs/edit

Allows users to edit specific details about a chosen song

POST
 https://api.elvanto.com/v1/songs/edit.{json|xml|php}

Parameters

Name Type Description
id Required text The UUID of the song you wish to edit.
title text The name of the song.
status integer Whether the song is Published or Archived. 0 for published. 1 for archived. Defaults to published.
number integer CCLI Number for the song.
item integer Whether the song is considered a "Song" or an "Item" - 0 for "Song" (Default) and 1 for "Item"
learn integer Whether the song is marked as a "To Learn" song for musicians or not. 1 to indicate it is "To Learn" - Defaults to 0
allow_downloads integer Whether the song's audio files can be downloaded or not. 1 to indicate audio files can be downloaded - Defaults to 0
Expected request JSON HTTP POST 
{
    "id": "e453b1a7-f681-48e8-97b6-e3a6c2b6a8c6",
    "title": "New Song Title",
    "number": 14554,
    "allow_downloads": 1
}
Expected response JSON XML PHP 
{
    "generated_in": "0.021",
    "status": "ok",
    "song": {
        "id": "e453b1a7-f681-48e8-97b6-e3a6c2b6a8c6"
    }
}
Error responses

Please see our response status codes documentation for details of potential error responses for any API request.