# Media API

The Media Endpoint offers the most important Methods for most Usecases. Due to the fact, that the nexxOMNIA API supports a variety of Media Types ("Streamtypes"), this Documentation will only mention "streamtype" as Endpoint Parameter, which can be replaced and is valid for all the following Streamtypes.

## Default Media

#### Video

**Live**

**Scenes**

**Audio**

**Radio**

**Images**

**Files**

**Articles**

**Events**

**Posts**

{% hint style="info" %}
Please notice, that the API uses always the Plural Form of a Streamtype in URL Building.
{% endhint %}

## Container Media

in various Cases, there are "Collections" of Media in one Container. These "Container Media" are often also references as "Parent" and they take the following Streamtypes:

#### Playlists

Container for Videos

#### Series

Container for Playlists

#### Audio Albums

Container for Audio

#### Albums

Container for Images

#### Magazines

Container for Articles

#### Folders

Container for Files

#### Groups

Container for Persons

#### Racks

Container for Video/Scene/LiveStream Alternatives

#### Sets

Container for Lists of Videos and Scenes

#### Collections

Container for Lists of all single Streamtypes

#### Bundles

Container for Lists of Container Elements

#### Teams

Container for Users

{% hint style="info" %}
Container Media Types are handled identically in the Media API. They use the same Endpoints and Methods as "Default Media".
{% endhint %}

## Referencing Media

Some Streamtypes are rarely used directly, but often used on other Media Types. For example, a Video might have a List of Links or Files connected to it. These are "referencing Media Items"

#### Persons

**Shows**

**Places**

**Products**

**Links**

**Studios**

{% hint style="info" %}
Referencing Media Types are also handled identically in the Media API. They use the same Endpoints and Methods as "Default Media".
{% endhint %}

## Interaction Media

The Media API also handles "interaction Media", which contains Object for Users to interact with.

**Forms**

**Polls**

**Votings**

{% hint style="info" %}
Interaction Media Types are also handled identically in the Media API. They use the same Endpoints and Methods as "Default Media".
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api.docs.nexx.cloud/media-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.