Docs
V2 APIMedia

List media folders

The folders of the media library. Folders do not nest: each is account-wide or belongs to one property.

GET/api/v2/media-folders

The folders of the media library. Folders do not nest: each is account-wide or belongs to one property.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

account_id?string

Optional account to run this request against. Defaults to the account the API token is scoped to, so callers with a single account can omit it. Must be an account the authenticated user belongs to; staff may target any account. For write requests the value may be sent in the JSON body instead of the query string. The resolved account is returned on the X-Resi-Account-Id response header.

Formatuuid
per_page?integer
Range1 <= value <= 200
Default15
property_id?string
Formatuuid
name?string

Partial match on the name.

sort?string

Sort by any filter field; prefix with - for descending. Defaults to name.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v2/media-folders"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "property_id": "05003a8a-8f3c-454b-8884-a906ec46f5f5",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "links": {    "first": "string",    "last": "string",    "prev": "string",    "next": "string"  },  "meta": {    "current_page": 0,    "from": 0,    "last_page": 0,    "links": [      {        "url": "string",        "label": "string",        "page": 0,        "active": true      }    ],    "path": "string",    "per_page": 200,    "to": 0,    "total": 0  }}