Update the fields of a playlist. Send only the fields to change. You must be an administrator, or a manager in the team of the project. A supervisor in the team can also do it on the playlists they created and on the playlists with no creator. You cannot change id, created_at, updated_at and project_id. for_entity must be a valid value. In shots, each entry keeps only entity_id and preview_file_id. The route removes a preview that does not belong to its entity. Dates use the ISO 8601 format.
PUT
/data/playlists/{instance_id}
curl
curl -X PUT "http://api.example.com/data/playlists/a24a6ea4-ce75-4665-a070-57453082c25" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "Updated Playlist Name",
"shots": []
}'import requests
url = "http://api.example.com/data/playlists/a24a6ea4-ce75-4665-a070-57453082c25"
headers = {
"Authorization": "Bearer YOUR_API_TOKEN",
"Accept": "application/json",
"Content-Type": "application/json"
}
params = {}
payload = {
"name": "Updated Playlist Name",
"shots": []
}
response = requests.put(
url,
headers=headers,
params=params,
json=payload
)
response.raise_for_status()
if response.content:
print(response.json())
Request examples
{
"name": "Updated Playlist Name",
"shots": [
{
"entity_id": "b24a6ea4-ce75-4665-a070-57453082c250",
"preview_file_id": "c24a6ea4-ce75-4665-a070-57453082c250"
}
]
}
Response examples (200)
{
"id": "a24a6ea4-ce75-4665-a070-57453082c250",
"name": "Updated Playlist Name",
"project_id": "b24a6ea4-ce75-4665-a070-57453082c250",
"shots": [
{}
],
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T11:00:00Z"
}