1. API
  2. Songs

songs/arrangements/edit

Allows a user to edit a specific arrangement's details.

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

Parameters

Name Type Description
id Required string The ID of the arrangement to edit
name string The new name of the arrangement
copyright string Copyright details for this arrangement
sequence array An array of strings, detailing the sequence of the song.
minutes number How long the arrangement is in minutes. A song that goes for 3 minutes and 45 seconds would have 3 in this field
seconds number The number of seconds for the songs length. A song that goes for 3 minutes and 45 seconds would have 45 in this field
bpm number The BPM (Beats per Minute) of the arrangement
key_male string Male led key
key_female string Female led key
chord_chart_key string Original Key for the Chord Chart to transpose from
chord_chart string Chord Chart in ChordPro format, with newlines represented as n characters
Expected request JSON HTTP POST 
{
    "id": "3ef550f4-7b98-4052-a445-826b7303ab33",
    "name": "Modern Arrangement",
    "copyright": "2024 Music Company",
    "sequence": [
        "Verse 1",
        "Chorus",
        "Verse 2",
        "Chorus",
        "Bridge",
        "Verse 3",
        "Chorus"
    ],
    "minutes": 3,
    "seconds": 45,
    "bpm": 82,
    "chord_chart_key": "A#m",
    "chord_chart": "VERSE 1\\n[A]This is my [C]Glad Noise!\\nFor the [D]Lord I make Glad Noises!\\n\\nCHORUS\\n[C]Make them loudly!\\n[F]I may not make them nicely!\\n[G]But loud and glad they are!"
}
Expected response JSON XML PHP 
{
    "generated_in": "0.021",
    "status": "ok",
    "arrangement": {
        "id": "3ef550f4-7b98-4052-a445-826b7303ab33"
    }
}
Error responses

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