minimusdocs
Help center

Playlist editor

Move a playlist to a new provider

POST/editor/playlists/{pid}/migrate/apply/

write Change: creates or edits. Scopes

Moves the playlist to the provider a comparison (job) read, in a background task: each entry takes its pair's link, or the one choices gives (entry id → the new provider's key, "" for none). Entries without one are deleted, hidden or kept (missing), and the old providers replaced, merged or kept (providers). When they are replaced, users drops customers' own lines on them, so customers follow the playlist.

Path parameters

  • pidstring (uuid)required

Body

  • jobstring (uuid)required
  • choicesobject
  • missingstring

    Default: "delete"

  • providersstring

    Default: "replace"

  • usersboolean

    Default: true

Response

202 OK

  • jobstring (uuid)required

    The background task: follow it with GET /editor/jobs/{id}/ (/editor/api/v1/jobs/{id}/ with a token).

Errors

  • 400 Something sent is not valid. Each field that is wrong is named with what is wrong.
  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 404 Nothing with this id, or nothing the account can see.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means