Upsert a work-in-progress release snapshot

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 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",
    "contributors": [
      {
        "role": "Producer"
      }
    ]
  },
  "tracks": [
    {
      "language": "en",
      "contributors": [
        {
          "role": "Producer"
        }
      ]
    }
  ]
}

Response

Draft snapshot result

Changes

No recorded changes to this endpoint across all 1 revision of this API.