ONonce

Upsert a work-in-progress release snapshot

Changed on

Pass release_id (or conversation_id) to update an existing draft. When neither is provided, a new draft release is created from the payload and its releaseId is returned with releaseCreated: true — reuse it on follow-up calls. Drafts do not enforce submission validation, but the response reports submittable (boolean) and submissionWarnings (array of per-field messages) so an unsubmittable draft surfaces before POST /releases.

post/drafts

Request

Request body

track_patchesobject[]
upload_requestsobject[]
statusstring
mode'delta' | 'replace'
release_idstring

Existing draft release to update. Omit together with conversation_id to create a new draft release.

conversation_idstring

Existing chat conversation whose draft should be updated.

Example request

{
  "release": {
    "audio_language": "en",
    "metadata_language": "en",
    "language_and_script_code": "ja-Kana",
    "contributors": [
      {
        "role": "Producer"
      }
    ],
    "artist_locals": [
      {
        "language_and_script_code": "ja-Latn"
      }
    ],
    "title_locals": [
      {
        "language_and_script_code": "ja-Latn"
      }
    ]
  },
  "tracks": [
    {
      "language": "en",
      "language_and_script_code": "ja-Kana",
      "contributors": [
        {
          "role": "Producer"
        }
      ],
      "artist_locals": [
        {
          "language_and_script_code": "ja-Latn"
        }
      ],
      "title_locals": [
        {
          "language_and_script_code": "ja-Latn"
        }
      ]
    }
  ]
}

Response

Draft snapshot result

Changes

  • cc6a2adfcbceRevision changes
    • info

      added the new optional request property ///

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property ////

    • info

      added the new optional request property //

    • info

      added the new optional request property //