Get a list of media groups

Published on Aug 7, 2026

Get

/v{version}/MediaGroups

Media groups are implicitly filtered by the user's read permission. By default, archived media groups are not returned.

Security

API Key: api_key

Header parameter nameX-ApiKey

Api Key

API Key: session_id

Header parameter nameX-Session-Id

Session Id

Path parameters

version

stringRequired

The requested API version

Query parameters

includeArchived

boolean

If true, archived media groups are included in the returned list. Default: false.

locationId

integer (int32)

Unique ID of the location

name

string

Name of the media group

Responses

200

Returns the list of media groups.

Array of object

object

Media group

AllowArchiving

boolean

If true, the media group allows archiving. Default: false.

AllowMediaArchiving

boolean

If true, the media group allows media archiving. Default: false.

Created

string (date-time)

Creation date in UTC

integer (int32)

Unique ID of the media group

IsArchived

boolean

If true, the media group is archived. Default: false.

LocationId

integer (int32)

Unique ID of the location assigned to the media group

Modified

string (date-time)

Modification date in UTC

Name

string

Name of the media group

ParentId

integer (int32)

Unique ID of the parent media group

Permissions

object

Permissions of the media group

Read

boolean

Write

boolean

Create

boolean

Delete

boolean

400

Bad request if parameters are invalid.

Expand All

object

ValidationErrors

object

property*

Array of string additionalProperties

string

401

Unauthorized

Expand All

object

string

Message

string

Type

string

Values

object

property*

object additionalProperties

403

Access denied

Expand All

object

string

Message

string

Type

string

Values

object

property*

object additionalProperties

500

Unexpected error

Expand All

object

string

Message

string

Type

string

Values

object

property*

object additionalProperties