Sign in

v51

latestOpenAPI 3.0.0AGPLv3 or laterraw.githubusercontent.com2026-08-0126276829.1 KB
library

Library Search

Search the Library for this user

get/library

Query parameters

mediaIdinteger

Filter by Media Id

mediastring

Filter by Media Name

typestring

Filter by Media Type

ownerIdinteger

Filter by Owner Id

retiredinteger

Filter by Retired

tagsstring

Filter by Tags - comma seperated

exactTagsinteger

A flag indicating whether to treat the tags filter as an exact match

logicalOperatorstring

When filtering by multiple Tags, which logical operator should be used? AND|OR

durationstring

Filter by Duration - a number or less-than,greater-than,less-than-equal or great-than-equal followed by a | followed by a number

fileSizestring

Filter by File Size - a number or less-than,greater-than,less-than-equal or great-than-equal followed by a | followed by a number

ownerUserGroupIdinteger

Filter by users in this UserGroupId

folderIdinteger

Filter by Folder ID

isReturnPublicUrlsinteger

Should the thumbnail URLs be authenticated S3 style public URL, default = false

modifiedDateFromstring date

Start date for filtering media by modified date

modifiedDateTostring date

End date for filtering media by modified date

sortBy'mediaId' | 'name' | 'type' | 'duration' | 'fileSize' | 'owner' | 'sharing' | 'released' | 'fileName' | 'enableStat' | 'createdAt' | 'modifiedDt' | 'expires' | 'revised' | 'formattedDuration' | 'durationSeconds' | 'fileSizeFormatted' | 'mediaType' | 'resolution' | 'groupsWithPermissions'

Specifies which field the results are sorted by. Used together with sortDir

sortDir'asc' | 'desc'

Sort direction

Response

successful operation

mediaIdinteger

The Media ID

ownerIdinteger

The ID of the User that owns this Media

parentIdinteger

The Parent ID of this Media if it has been revised

namestring

The Name of this Media

mediaTypestring

The module type of this Media

storedAsstring

The file name of the media as stored in the library

fileNamestring

The original file name as it was uploaded

fileSizeinteger

The file size in bytes

durationinteger

The duration to use when assigning this media to a Layout widget

validinteger

Flag indicating whether this media is valid.

moduleSystemFileinteger

DEPRECATED: Flag indicating whether this media is a system file or not

expiresinteger

Timestamp indicating when this media should expire

retiredinteger

Flag indicating whether this media is retired

isEditedinteger

Flag indicating whether this media has been edited and replaced with a newer file

md5string

A MD5 checksum of the stored media file

ownerstring

The username of the User that owns this media

groupsWithPermissionsstring

A comma separated list of groups/users with permissions to this Media

releasedinteger

A flag indicating whether this media has been released

apiRefstring

An API reference

createdDtstring

The datetime the Media was created

modifiedDtstring

The datetime the Media was last modified

enableStatstring

The option to enable the collection of Media Proof of Play statistics

orientationstring

The orientation of the Media file

widthinteger

The width of the Media file

heightinteger

The height of the Media file

folderIdinteger

The id of the Folder this Media belongs to

permissionsFolderIdinteger

The id of the Folder responsible for providing permissions for this Media