carnet

Renommer, changer la pochette ou reordonner une playlist

Modification PARTIELLE : seuls les champs PRESENTS bougent. coverEmoji: null retire la pochette. songIds, s'il est present, remplace ENTIEREMENT le contenu et son ordre.

Playlist inconnue ou appartenant a un autre compte : 404 indifferencie.

patch/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
coverEmojistring nullable
songIdsstring[]

Response

Playlist modifiee

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.