---
title: "Arrange Videos In Playlist"
method: POST
path: "/video/playlists/{playlist_id}/reorder"
tags: ["API Endpoints"]
---

# Arrange Videos In Playlist

`POST /video/playlists/{playlist_id}/reorder`

## Request

- Base URL: `https://api.gumlet.com/v1`
- URL: `https://api.gumlet.com/v1/video/playlists/{playlist_id}/reorder`
- Auth: API key in header `Authorization`

Reorder videos inside a playlist either by moving a single asset to a position or by sorting the playlist by title or created date.

## Path parameters

- `playlist_id` string, required

## Request body

- union
  - object
    - `asset_id` string, required: Asset id to move.
    - `page_number` integer, required: Current playlist page number.
    - `page_size` integer, required: Playlist page size used by the caller.
    - `asset_position` integer, required: Zero-based position inside the provided page.
  - object
    - `sort_by` 'title' | 'created_at', required
    - `sort_order` 'asc' | 'desc', required

## Response `200`

200

- object
  - `success` boolean
  - `asset_list` string[]

## Other responses

- `400`: 400
- `404`: 404

---

[API](https://skmtc.dev/gumlet/apis/gumlet-rest-apis.md) - [All operations](https://skmtc.dev/gumlet/apis/gumlet-rest-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/gumlet/apis/gumlet-rest-apis/revisions/b1f7ac2aeeec?raw)
