Media Manager

List media library items - Version 2

Enumerate items in the media library. If no filters are applied it will list all available media library items.

GET

/api/v2/media

curl --request GET \
  --url 'https://voyager.korbyt.com/api/v2/media?verbose=true&since=2018-09-20T00%3A00%3A00Z&tag=dogs&id=4362&name=large&type=video&folder=%2FUnassigned&page=1&order=created&direction=asc' \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "access_url": "https://voyager.korbyt.com/api/v1/media/access/10120_Campus_Map.PNG",
      "created": "2018-04-05T15:09:52.000Z",
      "folder": "/",
      "id": "1488",
      "name": "Campus Map",
      "on_disk": "10120_Campus_Map.PNG",
      "size": "298881",
      "tags": [
        "maps"
      ],
      "thumbnail_access_url": "https://voyager.korbyt.com/api/v1/media/access/thumbnail/10120_Campus_Map.PNG",
      "type": "image/png",
      "updated": "2019-08-14T18:56:13.446Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 75,
    "totalCount": 1,
    "totalPages": 1
  }
}

Note: If using multiple search parameters, the results will be return only if all of the search parameters match.

Authorizations

Authorizationstringheaderrequired

Access token from POST /api/v1/auth/login

Query Parameters

verbosebooleanquery

Verbose output flag

Example: true

sincestringquery

Starting date in utc

Example: 2018-09-20T00:00:00Z

tagstringquery

Search tag

Example: dogs

idintegerquery

Returns details on media item with specified id

Example: 4362

namestringquery

Returns details on the item that contains text specified (case insensitive)

Example: large

typestringquery

Returns details on items of a particular mime type (partial type string allowed)

Example: video

folderstringquery

Returns details on items directly inside specified folder

Example: /Unassigned

pageintegerquery

page of results to select

Example: 1

orderstringquery

the options are created, updated, type, id, name and size. default is created

Example: created

directionstringquery

asc or desc. default is asc

Example: asc

Response

Success (schema inferred from live response captured 2026-10-07)

dataobject[]

Show child attributes

paginationobject

Show child attributes

Still need help? Share an idea