# Episodes

Access to episode metadata and general information.

## List all available episodes

 - [GET /playouts/{playoutId}/episodes](https://docs.jay-metadata.com/apis/playout/latest/openapi/episodes/listavailableepisodes.md): Collects all episodes from the specified tenant's content library with optional filtering.


This endpoint retrieves episodes from the content repository based on the provided tenant ID
and applies any specified filters. It performs a search against the playout exporter
configurations to find matching episodes and verifies their availability in the storage.


The filtering system supports both exact matching and case-insensitive partial matching
when the filter value is prefixed with a tilde (~).

## Get episode details

 - [GET /playouts/{playoutId}/episodes/{episodeId}](https://docs.jay-metadata.com/apis/playout/latest/openapi/episodes/getepisodedetails.md): Get comprehensive details about a specific episode including title, description, duration, and associated group information.


This endpoint provides the foundation data needed to present an episode to viewers and provides
access to its interactive components.


Args:

    request: the complete request.
    playout_id: The playout identifier (aka tenant identifier).

    episode_id: The episode identifier

    inline_level: The number of levels to expand inner object inline.


Returns:

    ResultResponse[PlayoutEpisode]: The Result response which contains the episode details.


Raises:

    HTTPException: If the episode is not found (404) or descriptions are not available.