Playlists
Update a playlist
Partial update — only keys present in the payload are changed. After the
update, Lighthouse and compliance scans are queued automatically. With
lang, the translatable fields (title, description) are written
for that locale only — the default-locale copy is untouched; omitting
lang writes the default locale.
PATCH
/
api
/
v202604
/
company
/
playlists
/
{id}
Update a playlist
curl --request PATCH \
--url https://api.fluid.app/api/v202604/company/playlists/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"library": {
"title": "New Rep Starter Kit 2026",
"library_items_attributes": [
{
"relateable_id": 5214,
"relateable_type": "EnrollmentPack",
"order": 4
}
]
}
}
'import requests
url = "https://api.fluid.app/api/v202604/company/playlists/{id}"
payload = { "library": {
"title": "New Rep Starter Kit 2026",
"library_items_attributes": [
{
"relateable_id": 5214,
"relateable_type": "EnrollmentPack",
"order": 4
}
]
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
library: {
title: 'New Rep Starter Kit 2026',
library_items_attributes: [{relateable_id: 5214, relateable_type: 'EnrollmentPack', order: 4}]
}
})
};
fetch('https://api.fluid.app/api/v202604/company/playlists/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v202604/company/playlists/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'library' => [
'title' => 'New Rep Starter Kit 2026',
'library_items_attributes' => [
[
'relateable_id' => 5214,
'relateable_type' => 'EnrollmentPack',
'order' => 4
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/company/playlists/{id}"
payload := strings.NewReader("{\n \"library\": {\n \"title\": \"New Rep Starter Kit 2026\",\n \"library_items_attributes\": [\n {\n \"relateable_id\": 5214,\n \"relateable_type\": \"EnrollmentPack\",\n \"order\": 4\n }\n ]\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.fluid.app/api/v202604/company/playlists/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"library\": {\n \"title\": \"New Rep Starter Kit 2026\",\n \"library_items_attributes\": [\n {\n \"relateable_id\": 5214,\n \"relateable_type\": \"EnrollmentPack\",\n \"order\": 4\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/company/playlists/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"library\": {\n \"title\": \"New Rep Starter Kit 2026\",\n \"library_items_attributes\": [\n {\n \"relateable_id\": 5214,\n \"relateable_type\": \"EnrollmentPack\",\n \"order\": 4\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"status": 200,
"meta": {
"request_id": "7f3c9a1e-52d4-4b8e-9c61-2a8e4f0d7b35",
"timestamp": "2026-09-22T14:12:48Z"
},
"playlist": {
"id": 6021,
"slug": "new-rep-starter-kit",
"title": "New Rep Starter Kit 2026",
"description": "Everything a new Dunder Mifflin rep needs in their first week: product training, the paper catalog, and the starter pack.",
"image_url": "https://cdn.fluid.app/dunder-mifflin/playlists/new-rep-starter-kit.png",
"canonical_url": "https://shop.dundermifflin.com/home/libraries/new-rep-starter-kit",
"images": {
"thumb": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-200,c-at_max,f-auto,q-70/dunder-mifflin/playlists/new-rep-starter-kit.png",
"width": 200
},
"medium": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/dunder-mifflin/playlists/new-rep-starter-kit.png",
"width": 600
},
"large": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-1200,c-at_max,f-auto,q-80/dunder-mifflin/playlists/new-rep-starter-kit.png",
"width": 1200
}
},
"active": true,
"status": "published",
"publish_at": null,
"created_at": "2026-09-02T15:20:00Z",
"updated_at": "2026-09-22T14:12:48Z",
"seo": {
"title": "New Rep Starter Kit 2026",
"description": "Everything a new Dunder Mifflin rep needs in their first week: product training, the paper catalog, and the starter pack.",
"image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/dunder-mifflin/playlists/new-rep-starter-kit.png",
"indexable": true,
"id": 15230
},
"metafields": [],
"languages": [
"en",
"es"
],
"kind": "manual",
"countries": [],
"total_items_count": 4,
"library_items": [
{
"id": 91544,
"relateable_type": "Medium",
"relateable_id": 27561,
"relateable_slug": "why-our-paper-never-jams",
"order": 1
},
{
"id": 91545,
"relateable_type": "Product",
"relateable_id": 48213,
"relateable_slug": "schrute-farms-beet-blend",
"order": 2
},
{
"id": 91546,
"relateable_type": "Medium",
"relateable_id": 27564,
"relateable_slug": "the-scranton-branch-tour",
"order": 3
},
{
"id": 91547,
"relateable_type": "EnrollmentPack",
"relateable_id": 5214,
"relateable_slug": "scranton-starter-pack",
"order": 4
}
],
"custom_slug": true,
"owner": null
}
}{
"message": "Invalid credentials."
}{
"error": "Not authorized."
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 25,
"prev_cursor": "<string>",
"next_cursor": "<string>"
}
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 25,
"prev_cursor": "<string>",
"next_cursor": "<string>"
}
}
}Authorizations
Bearer token authentication. Accepts company-admin tokens with
storefront.view for read operations and storefront.update
for writes and scan triggers (legacy per-resource grants like
categories.update / products.view / etc. are still accepted
during the migration), required on every company operation.
Storefront public operations under /api/v202604/{resource} and
/api/v202604/{resource}/{slug} are unauthenticated
(security: []).
Path Parameters
The unique identifier of the playlist.
Query Parameters
Response locale. ISO code (e.g. fr, de). When omitted,
responds in the company's default locale. On reads an
unsupported or unknown locale is ignored — the response comes
back in the default locale, never a 422. Any translated field
with no value in the requested locale falls back to its en
value.
Example:
"fr"
Body
application/json
The wrapper key is library (the resource's legacy
name), while the URL resource is playlists — this mismatch is
intentional, not a typo. The write payload nests under library;
with additionalProperties: false a { playlist: ... } body is
rejected.
Show child attributes
Show child attributes
Response
Updated playlist.
Shared success envelope for list / show / create / update
responses: the resource payload is returned alongside a top-level
integer status and meta. Composed onto each resource response
via allOf.
Example:
200
Response metadata included on every successful response body.
request_id and timestamp are always present; list endpoints
also add pagination.
Show child attributes
Show child attributes
Authenticated (company-surface) Playlist read shape: the public
PlaylistBase plus custom_slug and owner, admin metadata never
rendered on the public surface.
Show child attributes
Show child attributes
⌘I
Update a playlist
curl --request PATCH \
--url https://api.fluid.app/api/v202604/company/playlists/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"library": {
"title": "New Rep Starter Kit 2026",
"library_items_attributes": [
{
"relateable_id": 5214,
"relateable_type": "EnrollmentPack",
"order": 4
}
]
}
}
'import requests
url = "https://api.fluid.app/api/v202604/company/playlists/{id}"
payload = { "library": {
"title": "New Rep Starter Kit 2026",
"library_items_attributes": [
{
"relateable_id": 5214,
"relateable_type": "EnrollmentPack",
"order": 4
}
]
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
library: {
title: 'New Rep Starter Kit 2026',
library_items_attributes: [{relateable_id: 5214, relateable_type: 'EnrollmentPack', order: 4}]
}
})
};
fetch('https://api.fluid.app/api/v202604/company/playlists/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v202604/company/playlists/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'library' => [
'title' => 'New Rep Starter Kit 2026',
'library_items_attributes' => [
[
'relateable_id' => 5214,
'relateable_type' => 'EnrollmentPack',
'order' => 4
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/company/playlists/{id}"
payload := strings.NewReader("{\n \"library\": {\n \"title\": \"New Rep Starter Kit 2026\",\n \"library_items_attributes\": [\n {\n \"relateable_id\": 5214,\n \"relateable_type\": \"EnrollmentPack\",\n \"order\": 4\n }\n ]\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.fluid.app/api/v202604/company/playlists/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"library\": {\n \"title\": \"New Rep Starter Kit 2026\",\n \"library_items_attributes\": [\n {\n \"relateable_id\": 5214,\n \"relateable_type\": \"EnrollmentPack\",\n \"order\": 4\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/company/playlists/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"library\": {\n \"title\": \"New Rep Starter Kit 2026\",\n \"library_items_attributes\": [\n {\n \"relateable_id\": 5214,\n \"relateable_type\": \"EnrollmentPack\",\n \"order\": 4\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"status": 200,
"meta": {
"request_id": "7f3c9a1e-52d4-4b8e-9c61-2a8e4f0d7b35",
"timestamp": "2026-09-22T14:12:48Z"
},
"playlist": {
"id": 6021,
"slug": "new-rep-starter-kit",
"title": "New Rep Starter Kit 2026",
"description": "Everything a new Dunder Mifflin rep needs in their first week: product training, the paper catalog, and the starter pack.",
"image_url": "https://cdn.fluid.app/dunder-mifflin/playlists/new-rep-starter-kit.png",
"canonical_url": "https://shop.dundermifflin.com/home/libraries/new-rep-starter-kit",
"images": {
"thumb": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-200,c-at_max,f-auto,q-70/dunder-mifflin/playlists/new-rep-starter-kit.png",
"width": 200
},
"medium": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/dunder-mifflin/playlists/new-rep-starter-kit.png",
"width": 600
},
"large": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-1200,c-at_max,f-auto,q-80/dunder-mifflin/playlists/new-rep-starter-kit.png",
"width": 1200
}
},
"active": true,
"status": "published",
"publish_at": null,
"created_at": "2026-09-02T15:20:00Z",
"updated_at": "2026-09-22T14:12:48Z",
"seo": {
"title": "New Rep Starter Kit 2026",
"description": "Everything a new Dunder Mifflin rep needs in their first week: product training, the paper catalog, and the starter pack.",
"image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/dunder-mifflin/playlists/new-rep-starter-kit.png",
"indexable": true,
"id": 15230
},
"metafields": [],
"languages": [
"en",
"es"
],
"kind": "manual",
"countries": [],
"total_items_count": 4,
"library_items": [
{
"id": 91544,
"relateable_type": "Medium",
"relateable_id": 27561,
"relateable_slug": "why-our-paper-never-jams",
"order": 1
},
{
"id": 91545,
"relateable_type": "Product",
"relateable_id": 48213,
"relateable_slug": "schrute-farms-beet-blend",
"order": 2
},
{
"id": 91546,
"relateable_type": "Medium",
"relateable_id": 27564,
"relateable_slug": "the-scranton-branch-tour",
"order": 3
},
{
"id": 91547,
"relateable_type": "EnrollmentPack",
"relateable_id": 5214,
"relateable_slug": "scranton-starter-pack",
"order": 4
}
],
"custom_slug": true,
"owner": null
}
}{
"message": "Invalid credentials."
}{
"error": "Not authorized."
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 25,
"prev_cursor": "<string>",
"next_cursor": "<string>"
}
}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 25,
"prev_cursor": "<string>",
"next_cursor": "<string>"
}
}
}