DistributeApp LogoDistributeProject
DistributorUsersUser_idFolders

Create folder

Creates a playlist folder. Requires that the JWT subject matches user_id or that the token has admin privileges.

POST
/users/{user_id}/folders

Authorization

BearerAuth
Authorization<token>

Type "Bearer" followed by a space and JWT token.

In: header

Path Parameters

user_id*string

User ID (UUID)

Request Body

application/json

Folder payload

id*string
name*string
parent_folder_id*string

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://loading/api/users/string/folders" \  -H "Content-Type: application/json" \  -d '{    "id": "00000000-0000-0000-0000-000000000000",    "name": "Favourites",    "parent_folder_id": "00000000-0000-0000-0000-000000000000"  }'
{
  "children": [
    {
      "children": [],
      "id": "string",
      "name": "string",
      "parent_id": "string",
      "playlists": [
        {
          "created_at": "string",
          "folder_id": "string",
          "id": "string",
          "name": "string",
          "song_ids": [
            "string"
          ],
          "user": {
            "id": "string",
            "is_admin": true,
            "root_folder_id": "string",
            "username": "string"
          },
          "user_id": "string"
        }
      ],
      "user_id": "string"
    }
  ],
  "id": "string",
  "name": "string",
  "parent_id": "string",
  "playlists": [
    {
      "created_at": "string",
      "folder_id": "string",
      "id": "string",
      "name": "string",
      "song_ids": [
        "string"
      ],
      "user": {
        "id": "string",
        "is_admin": true,
        "root_folder_id": "string",
        "username": "string"
      },
      "user_id": "string"
    }
  ],
  "user_id": "string"
}
{
  "error": "Validation failed"
}
{
  "error": "Validation failed"
}
{
  "error": "Validation failed"
}