Change media order in a playlist by ID | FastPix Developer Documentation

curl -X PUT https://api.fastpix.com/v1/on-demand/playlists/playlistId/media \
     -H "Content-Type: application/json" \
     -u "<username>:<password>" \
     -d '{
  "mediaIds": [
    "a1cd180e-f9b5-4e99-9d44-b9c9baabad89",
    "245800c3-7b73-47d9-a201-e961260dcb30",
    "41316aac-5396-4278-8f44-08d5f2495b12"
  ]
}'

{
  "success": true,
  "data": {
    "id": "46d5fce1-683a-457f-86d7-c048bb429505",
    "name": "My Playlist",
    "referenceId": "122q",
    "type": "smart",
    "description": "This Playlist contains videos from December 2024.",
    "playOrder": "createdDate DESC",
    "metadata": {
      "createdData": {
        "endDate": "2024-12-12T00:00:00.000Z",
        "startDate": "2024-12-11T00:00:00.000Z"
      },
      "updatedData": {
        "endDate": "2024-12-12T00:00:00.000Z",
        "startDate": "2024-12-11T00:00:00.000Z"
      }
    },
    "mediaList": [
      {
        "createdAt": "2025-05-27T09:37:52.445936Z",
        "creatorId": "FastPix@14612",
        "duration": "00:00:10",
        "id": "a1cd180e-f9b5-4e99-9d44-b9c9baabad89",
        "sourceResolution": "1080p",
        "status": "Ready",
        "thumbnail": "https://venus-images.fastpix.dev/bed25609-1887-4c49-91a5-5c6b1edeb1a2/thumbnail.png",
        "title": "Media 1"
      },
      {
        "createdAt": "2025-04-04T13:26:23.507284Z",
        "creatorId": "FastPix@14612",
        "duration": "00:00:10",
        "id": "245800c3-7b73-47d9-a201-e961260dcb30",
        "sourceResolution": "1080p",
        "status": "Ready",
        "thumbnail": "https://mercury-images.fastpix.dev/3c6ceeea-d24b-487f-9dd0-5a16148b5d46/thumbnail.png",
        "title": "Media 2"
      },
      {
        "createdAt": "2025-04-04T13:26:12.552840Z",
        "creatorId": "FastPix@14612",
        "duration": "00:00:10",
        "id": "41316aac-5396-4278-8f44-08d5f2495b12",
        "sourceResolution": "1080p",
        "status": "Ready",
        "thumbnail": "https://mercury-images.fastpix.dev/8989d0d3-5c5b-41b2-89d5-df6094e6093f/thumbnail.png",
        "title": "Media 3"
      }
    ],
    "workspaceId": "d760b903-86ef-44d6-9b73-334130e0cf2d",
    "createdAt": "2025-06-05T09:10:30.655275Z",
    "updatedAt": "2025-06-05T12:23:47.096690Z",
    "mediaCount": 3
  }
}

This endpoint allows you to change the order of media items within a playlist. By passing the complete list of media IDs in the desired sequence, the playlist’s play order is updated accordingly.

How it works

When a user sends a PUT request to this endpoint with the playlistId as path parameter and the reordered list of all media IDs in the request body, FastPix updates the playlist to reflect the new media sequence and returns the updated playlist details.

Example

An e-learning platform rearranges the “Beginner Python Series” playlist by submitting a reordered list of media IDs. The playlist now follows the new sequence, providing learners with a better structured learning path.

This endpoint allows you to change the order of media items within a playlist. By passing the complete list of media IDs in the desired sequence, the playlist's play order is updated accordingly. #### How it works - When a user sends a PUT request to this endpoint with the `playlistId` as path parameter and the reordered list of all media IDs in the request body, FastPix updates the playlist to reflect the new media sequence and returns the updated playlist details. #### Example An e-learning platform rearranges the "Beginner Python Series" playlist by submitting a reordered list of media IDs. The playlist now follows the new sequence, providing learners with a better structured learning path.

Authentication

AuthorizationBasic

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request.

Username: Access Token ID
Password: Secret Key

Activate your FastPix account to generate your API credentials. See the guide here

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request. - <b>Username:</b> Access Token ID - <b>Password:</b> Secret Key Activate your FastPix account to generate your API credentials. <a href="https://docs.fastpix.io/docs/activate-account" target="_blank">See the guide here</a>

Path parameters

playlistIdstringRequired

The unique id of the playlist you want to perform the operation on.

Request

This endpoint expects an object.

mediaIdslist of stringsRequired

Response

Added media to playlist successfully

successboolean

Shows the request status. Returns true for success and false for failure.

dataobject

This endpoint allows you to change the order of media items within a playlist. By passing the complete list of media IDs in the desired sequence, the playlist’s play order is updated accordingly.

How it works

When a user sends a PUT request to this endpoint with the playlistId as path parameter and the reordered list of all media IDs in the request body, FastPix updates the playlist to reflect the new media sequence and returns the updated playlist details.