staqlydocs
REST APIAPI referenceMedia

The library's folders, file counts and tags

The library's folders, file counts and tags (media:read)

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.

GET
/v1/media-folders

Authorization

headerAuthorizationBearer <token>

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

Response Body

The tree

application/json
  1. response
data*array<>
root_files*integer

Files at the top level

total_files*integer

Files in the library (not in Deleted)

deleted_files*integer

Files in Deleted

duplicate_files*integer

Files with at least one identical twin

tags*array<>

Every tag on files, most used first

curl -X GET 'https://staqly.example.com/v1/media-folders'
{  "data": [    {      "id": "string",      "parent_id": "string",      "name": "string",      "files": 0,      "created_at": "2019-08-24T14:15:22Z"    }  ],  "root_files": 0,  "total_files": 0,  "deleted_files": 0,  "duplicate_files": 0,  "tags": [    {      "tag": "string",      "files": 0    }  ]}