staqlydocs
REST APIAPI referenceMedia

Rename a folder or move it under another one

Rename a folder or move it under another one (media:write)

Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.

PATCH
/v1/media-folders/{id}

A folder can't move inside itself or one of its own folders (422).

Authorization

headerAuthorizationBearer <token>

API key (stk_...), or in the Community Edition the access token (stk_local_...)

Path Parameters

id*string

Request Body

application/json
  1. body
name?string
Length1 <= length <= 80
parent_id?string

A folder id, or empty for the top level

Response Body

The folder

application/json
  1. response

A virtual folder of the media library

id*string
parent_id*string

The folder it sits in; empty at the top level

name*string
files*integer

Files directly in this folder (not in its subfolders)

created_at*string
Formatdate-time
curl -X PATCH 'https://staqly.example.com/v1/media-folders/string' \  -H 'Content-Type: application/json' \  -d '{}'
{  "id": "string",  "parent_id": "string",  "name": "string",  "files": 0,  "created_at": "2019-08-24T14:15:22Z"}