staqlydocs
REST APIAPI referenceMedia

Move several files to a folder and/or add and remove tags

Move several files to a folder and/or add and remove tags (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.

POST
/v1/media/bulk

Authorization

headerAuthorizationBearer <token>

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

Request Body

application/json
  1. body
ids*array<string>
Items1 <= items <= 200
folder_id?string

A folder id, or empty for the top level; omit to leave folders alone

add_tags?array<string>
remove_tags?array<string>

Response Body

Which files changed and which ids were not found

application/json
  1. response
updated*array<string>
missing*array<string>
curl -X POST 'https://staqly.example.com/v1/media/bulk' \  -H 'Content-Type: application/json' \  -d '{  "ids": [    "string"  ]}'
{  "updated": [    "string"  ],  "missing": [    "string"  ]}