carnet

Remplacer une playlist

DECLARATIF : la playlist DEVIENT exactement le corps envoye, d'ou songIds OBLIGATOIRE (« la playlist EST cette liste, dans cet ordre »). Pour ne changer qu'un champ, utiliser PATCH.

Si l'identifiant n'existe pas, il est CREE (201). If-Match est accepte, avec le meme contrat que sur les chansons.

put/me/playlists/{playlistId}

Request

  • Base URL: https://jam-jam.org/api/v1
  • URL: https://jam-jam.org/api/v1/me/playlists/{playlistId}
  • Auth: one of:
    • HTTP bearer
    • none

Path parameters

playlistIdstring required

Identifiant stable de la playlist (pl_...).

Headers

If-Matchstring

updatedAt ISO 8601 lu sur l'objet, avec ou sans guillemets ("2026-09-21T12:00:00.000Z" ou la forme nue). Si la valeur en base differe, l'ecriture est refusee par 409 conflict, dont le corps porte l'updatedAt serveur courant. Absent = dernier ecrivain gagne. If-Match: * n'est pas pris en charge (400).

Request body

namestring required
coverEmojistring nullable
songIdsstring[] required

Response

Playlist remplacee

idstring required

Identifiant stable de l'objet ecrit.

updatedAtstring date-time required

Horodatage serveur apres l'ecriture, en ISO 8601 UTC au millieme. C'est EXACTEMENT la valeur a renvoyer dans If-Match.

publishedboolean

Present UNIQUEMENT quand la requete portait publish : etat REEL de la publication apres l'ecriture. Un refus de publication n'est jamais un published: false silencieux, c'est un 409.

Changes

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