edit_draft
Apply ordered changes to a draft playlist—rename, move, assign, merge, or skip tracks—and refresh its page without writing anything to Spotify. All changes apply together or none do.
Instructions
Change a draft, then refresh its page. All the changes are applied in order, or none if one fails. Only the draft (and the organize progress it touches) changes; nothing is written to Spotify.
Args:
draft: the draft ID ("d3").
changes: a list of operations, each with an "op":
rename {group, to}; move {tracks, to, from_group?, create_if_missing?} between groups;
assign {tracks, to} puts unmatched tracks in a group (saved as manual progress, like the
original's "Save assignments"); drop_group {group} (its tracks stay in the pool, listed as
left out); merge {groups, into?}; keep_visible {group, on?} (its tracks aren't marked done
when written); skip_unmatched {} (marks the unmatched tracks without data as done, so they
leave the pool); reopen {group} (a done group counts as not done).
tracks picks tracks by artist, text (in the name), genre, genre_family, decade, year_from/to,
popularity, track_ids, reason (unmatched only) or all=true. Group names accept a unique part.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draft | Yes | ||
| changes | Yes |