# Emby

> Run your Emby media server from workflows: search and list films, shows and music, see who is watching what, message, pause or stop a player, scan libraries, fix an item's details, manage playlists, collections and users, and read the activity log. Start a workflow when something is added, playback starts or stops, someone finishes a film, a sign-in fails or a user is added.

App · 41 actions. Web page: https://docs.lodol.com/docs/integrations/emby

## Actions

### Add to collection

Add films or shows to a collection.

**Inputs**

- Collection (`collection`, text, required): The collection, by name or ID, or one an earlier step made.
- Items (`items`, text, required): One or more films, episodes or songs: exact names, links from Emby or IDs from an earlier step, separated by commas.

**Outputs**

- `added` (list): The items added
- `count` (number): How many were added
- `created_at` (text): When it was made (UTC)
- `id` (text): Its ID, for other Emby steps
- `name` (text): Its name
- `overview` (text): Its description
- `runtime_minutes` (number): How long everything in it runs, in minutes
- `web_url` (text): A link to it in Emby

**Example output**

```json
{
  "added": [
    {
      "id": "12",
      "name": "Harbor Lights"
    }
  ],
  "count": 1,
  "created_at": "2026-11-12T22:36:10Z",
  "id": "48",
  "name": "Harbor films",
  "overview": "",
  "runtime_minutes": 0.0,
  "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=48&serverId=c82de17ac3364560b5f0d5371f9d82d6"
}
```

### Add to favourites

Make an item one of a user's favourites.

**Inputs**

- Item (`item`, text, required): The film, show, episode, song or album: its exact name, its link from Emby, or the ID an earlier step found, such as Search media.
- User (`user`, text): Whose viewing this is about, by name or ID. Leave blank when the server has one user.

**Outputs**

- `favourite` (true/false): Whether it is now one of their favourites
- `id` (text): The item's ID
- `last_played_at` (text): When they last played it (UTC)
- `name` (text): Its title
- `play_count` (number): How many times they have played it
- `played` (true/false): Whether the user has now played it
- `type` (text): What it is, such as Movie
- `user_id` (text): The user's ID
- `user_name` (text): The user's name
- `web_url` (text): A link to it in Emby

**Example output**

```json
{
  "favourite": false,
  "id": "12",
  "last_played_at": "2026-11-12T22:36:10Z",
  "name": "Harbor Lights",
  "play_count": 1,
  "played": true,
  "type": "Movie",
  "user_id": "b3f34c08a38848c5818c168153ff70c2",
  "user_name": "sam",
  "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=12&serverId=c82de17ac3364560b5f0d5371f9d82d6"
}
```

### Add to playlist

Add films, episodes or songs to the end of a playlist.

**Inputs**

- Playlist (`playlist`, text, required): The playlist, by name or ID, or one an earlier step made.
- Items (`items`, text, required): One or more films, episodes or songs: exact names, links from Emby or IDs from an earlier step, separated by commas.

**Outputs**

- `added` (list): The items added
- `count` (number): How many were added
- `created_at` (text): When it was made (UTC)
- `id` (text): Its ID, for other Emby steps
- `name` (text): Its name
- `overview` (text): Its description
- `runtime_minutes` (number): How long everything in it runs, in minutes
- `web_url` (text): A link to it in Emby

**Example output**

```json
{
  "added": [
    {
      "id": "12",
      "name": "Harbor Lights"
    }
  ],
  "count": 1,
  "created_at": "2026-11-12T22:36:10Z",
  "id": "45",
  "name": "Friday night",
  "overview": "",
  "runtime_minutes": 208.0,
  "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=45&serverId=c82de17ac3364560b5f0d5371f9d82d6"
}
```

### Control playback

Pause, resume or stop what a player is playing, or skip to the next or previous track.

**Inputs**

- Session (`session`, text, required): The player: a session from List sessions, or the name of a user or device that is signed in on one.
- Command (`command`, text, required): What the player should do. One of: `pause`, `unpause` (Resume), `play_pause` (Play or pause), `stop`, `next` (Next track), `previous` (Previous track).

**Outputs**

- `app` (text): The app, such as Emby Web or Emby for Android
- `app_version` (text): The app's version
- `can_be_controlled` (true/false): Whether it takes messages and playback commands
- `command` (text): The command sent: pause, unpause, play_pause, stop, next or previous
- `device` (text): The device's name
- `device_id` (text): The device's own ID
- `id` (text): The session's ID, for Send message, Control playback and Play
- `is_paused` (true/false): Whether what it is playing is paused
- `is_playing` (true/false): Whether it is playing something (paused counts)
- `item_id` (text): The ID of what is playing; empty when idle
- `item_name` (text): The title of what is playing
- `item_type` (text): What is playing, such as Movie or Episode
- `last_activity_at` (text): When it was last heard from (UTC)
- `play_method` (text): DirectPlay, DirectStream or Transcode
- `position_minutes` (number): How far in it is, in minutes
- `runtime_minutes` (number): How long what is playing runs, in minutes
- `sent` (true/false): True once Emby has passed it on
- `show_name` (text): For an episode, its show
- `user_id` (text): The ID of the user signed in
- `user_name` (text): Their name

**Example output**

```json
{
  "app": "Emby Web",
  "app_version": "4.10.2.0",
  "can_be_controlled": true,
  "command": "pause",
  "device": "Chrome Windows",
  "device_id": "a0ab28af-5644-4c5a-81b1-0db2d57ac34f",
  "id": "dd4f087a76f7d20040016d1db9e770f0",
  "is_paused": false,
  "is_playing": true,
  "item_id": "12",
  "item_name": "Harbor Lights",
  "item_type": "Movie",
  "last_activity_at": "2026-11-14T21:40:00Z",
  "play_method": "DirectStream",
  "position_minutes": 23.7,
  "runtime_minutes": 104.0,
  "sent": true,
  "show_name": "",
  "user_id": "b3f34c08a38848c5818c168153ff70c2",
  "user_name": "sam"
}
```

### Create collection

Make a collection of films or shows. Emby needs at least one item to make it.

**Inputs**

- Name (`name`, text, required): What to call it.
- Items (`items`, text, required): One or more films, episodes or songs: exact names, links from Emby or IDs from an earlier step, separated by commas.

**Outputs**

- `added` (list): The items added
- `count` (number): How many were added
- `created_at` (text): When it was made (UTC)
- `id` (text): Its ID, for other Emby steps
- `name` (text): Its name
- `overview` (text): Its description
- `runtime_minutes` (number): How long everything in it runs, in minutes
- `web_url` (text): A link to it in Emby

**Example output**

```json
{
  "added": [
    {
      "id": "12",
      "name": "Harbor Lights"
    }
  ],
  "count": 1,
  "created_at": "2026-11-12T22:36:10Z",
  "id": "48",
  "name": "Harbor films",
  "overview": "",
  "runtime_minutes": 0.0,
  "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=48&serverId=c82de17ac3364560b5f0d5371f9d82d6"
}
```

### Create playlist

Make a playlist, empty or with items already in it.

**Inputs**

- Name (`name`, text, required): What to call it.
- Items (`items`, text): What to put in it: exact names, links from Emby or IDs from an earlier step, separated by commas. Leave blank for an empty playlist.
- For (`media`, text): Whether it holds video or audio. Only needed for an empty playlist. One of: `video`, `audio`. Default: `video`.
- User (`user`, text): Whose playlist it is, by name or ID. Leave blank for one that belongs to the server.

**Outputs**

- `added` (list): The items added
- `count` (number): How many were added
- `created_at` (text): When it was made (UTC)
- `id` (text): Its ID, for other Emby steps
- `name` (text): Its name
- `overview` (text): Its description
- `runtime_minutes` (number): How long everything in it runs, in minutes
- `web_url` (text): A link to it in Emby

**Example output**

```json
{
  "added": [
    {
      "id": "12",
      "name": "Harbor Lights"
    }
  ],
  "count": 1,
  "created_at": "2026-11-12T22:36:10Z",
  "id": "45",
  "name": "Friday night",
  "overview": "",
  "runtime_minutes": 208.0,
  "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=45&serverId=c82de17ac3364560b5f0d5371f9d82d6"
}
```

### Create user

Add a user who can sign in to Emby, such as a family member. They start with Emby's usual access: every library, no administration.

**Inputs**

- Name (`name`, text, required): The name they sign in with.
- Password (`password`, text): Their first password; they can change it in Emby. Leave blank for none.

**Outputs**

- `all_libraries` (true/false): Whether they can open every library
- `can_delete` (true/false): Whether they can delete media
- `can_play` (true/false): Whether they can play media
- `created_at` (text): When they were added (UTC)
- `has_password` (true/false): Whether they have a password
- `id` (text): The user's ID
- `is_admin` (true/false): Whether they are an administrator
- `is_disabled` (true/false): Whether they are disabled and can't sign in
- `is_hidden` (true/false): Whether they are hidden from the sign-in screen
- `last_activity_at` (text): When they were last active (UTC)
- `last_login_at` (text): When they last signed in (UTC)
- `name` (text): The name they sign in with
- `remote_access` (true/false): Whether they can connect from outside the home network

**Example output**

```json
{
  "all_libraries": true,
  "can_delete": false,
  "can_play": true,
  "created_at": "2026-11-12T22:36:09Z",
  "has_password": true,
  "id": "b3f34c08a38848c5818c168153ff70c2",
  "is_admin": false,
  "is_disabled": false,
  "is_hidden": false,
  "last_activity_at": "2026-11-14T21:40:00Z",
  "last_login_at": "2026-11-14T19:02:11Z",
  "name": "sam",
  "remote_access": true
}
```

### Delete an item

Delete an item from Emby and its files from the server's disk, as Emby's own Delete does. This can't be undone. To delete a playlist or collection and keep the media, use Delete playlist or Delete collection.

**Inputs**

- Item (`item`, text, required): The film, show, episode, song or album: its exact name, its link from Emby, or the ID an earlier step found, such as Search media.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `id` (text): Its ID
- `name` (text): Its name
- `type` (text): What it was, such as Movie, Playlist or BoxSet

**Example output**

```json
{
  "deleted": true,
  "id": "12",
  "name": "Harbor Lights",
  "type": "Movie"
}
```

### Delete collection

Delete a collection. What was in it stays in Emby.

**Inputs**

- Collection (`collection`, text, required): The collection, by name or ID, or one an earlier step made.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `id` (text): Its ID
- `name` (text): Its name
- `type` (text): What it was, such as Movie, Playlist or BoxSet

**Example output**

```json
{
  "deleted": true,
  "id": "48",
  "name": "Harbor films",
  "type": "BoxSet"
}
```

### Delete playlist

Delete a playlist. What was in it stays in Emby.

**Inputs**

- Playlist (`playlist`, text, required): The playlist, by name or ID, or one an earlier step made.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `id` (text): Its ID
- `name` (text): Its name
- `type` (text): What it was, such as Movie, Playlist or BoxSet

**Example output**

```json
{
  "deleted": true,
  "id": "45",
  "name": "Friday night",
  "type": "Playlist"
}
```

### Delete user

Delete a user, with what they have played and their favourites. This can't be undone.

**Inputs**

- User (`user`, text, required): The user, by name or ID.

**Outputs**

- `deleted` (true/false): True once they are deleted
- `id` (text): Their ID
- `name` (text): Their name

**Example output**

```json
{
  "deleted": true,
  "id": "b3f34c08a38848c5818c168153ff70c2",
  "name": "sam"
}
```

### Disable user

Stop a user signing in, and sign them out of their devices, without deleting them or what they have watched. The only administrator can't be disabled.

**Inputs**

- User (`user`, text, required): The user, by name or ID.

**Outputs**

- `all_libraries` (true/false): Whether they can open every library
- `can_delete` (true/false): Whether they can delete media
- `can_play` (true/false): Whether they can play media
- `created_at` (text): When they were added (UTC)
- `has_password` (true/false): Whether they have a password
- `id` (text): The user's ID
- `is_admin` (true/false): Whether they are an administrator
- `is_disabled` (true/false): Whether they are disabled and can't sign in
- `is_hidden` (true/false): Whether they are hidden from the sign-in screen
- `last_activity_at` (text): When they were last active (UTC)
- `last_login_at` (text): When they last signed in (UTC)
- `name` (text): The name they sign in with
- `remote_access` (true/false): Whether they can connect from outside the home network

**Example output**

```json
{
  "all_libraries": true,
  "can_delete": false,
  "can_play": true,
  "created_at": "2026-11-12T22:36:09Z",
  "has_password": true,
  "id": "b3f34c08a38848c5818c168153ff70c2",
  "is_admin": false,
  "is_disabled": true,
  "is_hidden": false,
  "last_activity_at": "2026-11-14T21:40:00Z",
  "last_login_at": "2026-11-14T19:02:11Z",
  "name": "sam",
  "remote_access": true
}
```

### Enable user

Let a disabled user sign in again.

**Inputs**

- User (`user`, text, required): The user, by name or ID.

**Outputs**

- `all_libraries` (true/false): Whether they can open every library
- `can_delete` (true/false): Whether they can delete media
- `can_play` (true/false): Whether they can play media
- `created_at` (text): When they were added (UTC)
- `has_password` (true/false): Whether they have a password
- `id` (text): The user's ID
- `is_admin` (true/false): Whether they are an administrator
- `is_disabled` (true/false): Whether they are disabled and can't sign in
- `is_hidden` (true/false): Whether they are hidden from the sign-in screen
- `last_activity_at` (text): When they were last active (UTC)
- `last_login_at` (text): When they last signed in (UTC)
- `name` (text): The name they sign in with
- `remote_access` (true/false): Whether they can connect from outside the home network

**Example output**

```json
{
  "all_libraries": true,
  "can_delete": false,
  "can_play": true,
  "created_at": "2026-11-12T22:36:09Z",
  "has_password": true,
  "id": "b3f34c08a38848c5818c168153ff70c2",
  "is_admin": false,
  "is_disabled": false,
  "is_hidden": false,
  "last_activity_at": "2026-11-14T21:40:00Z",
  "last_login_at": "2026-11-14T19:02:11Z",
  "name": "sam",
  "remote_access": true
}
```

### Get a user

Get one user: whether they are an administrator, disabled or hidden, what they may do, and when they last signed in.

**Inputs**

- User (`user`, text, required): The user, by name or ID.

**Outputs**

- `all_libraries` (true/false): Whether they can open every library
- `can_delete` (true/false): Whether they can delete media
- `can_play` (true/false): Whether they can play media
- `created_at` (text): When they were added (UTC)
- `has_password` (true/false): Whether they have a password
- `id` (text): The user's ID
- `is_admin` (true/false): Whether they are an administrator
- `is_disabled` (true/false): Whether they are disabled and can't sign in
- `is_hidden` (true/false): Whether they are hidden from the sign-in screen
- `last_activity_at` (text): When they were last active (UTC)
- `last_login_at` (text): When they last signed in (UTC)
- `name` (text): The name they sign in with
- `remote_access` (true/false): Whether they can connect from outside the home network

**Example output**

```json
{
  "all_libraries": true,
  "can_delete": false,
  "can_play": true,
  "created_at": "2026-11-12T22:36:09Z",
  "has_password": true,
  "id": "b3f34c08a38848c5818c168153ff70c2",
  "is_admin": false,
  "is_disabled": false,
  "is_hidden": false,
  "last_activity_at": "2026-11-14T21:40:00Z",
  "last_login_at": "2026-11-14T19:02:11Z",
  "name": "sam",
  "remote_access": true
}
```

### Get an item

Get everything Emby knows about one film, show, episode, song or album: its summary, genres, tags, cast, file and, for a user, whether they have played it.

**Inputs**

- Item (`item`, text, required): The film, show, episode, song or album: its exact name, its link from Emby, or the ID an earlier step found, such as Search media.
- User (`user`, text): Whose played and favourite marks to include, by name or ID. Leave blank for none.

**Outputs**

- `age_rating` (text): Its age rating, such as PG-13
- `album` (text): For a song, its album
- `album_artist` (text): For a song or album, the album's artist
- `artists` (list): For a song or album, its artists
- `child_count` (number): For a show, album or folder, how many things are in it
- `community_rating` (number): Its rating out of 10; 0 for none
- `container` (text): Its file's format, such as mkv
- `date_added` (text): When it was added to Emby (UTC)
- `episode_number` (number): For an episode, its number; 0 otherwise
- `favourite` (true/false): Whether it is one of the user's favourites; false when no user was given
- `genres` (list): Its genres
- `id` (text): The item's ID, for other Emby steps
- `imdb_id` (text): Its IMDb ID, when Emby has one
- `last_played_at` (text): When the user last played it (UTC)
- `name` (text): Its title
- `overview` (text): Its summary
- `path` (text): Where its file or folder is on the server
- `people` (list): Its cast and crew
- `play_count` (number): How many times the user has played it
- `played` (true/false): Whether the user has played it; false when no user was given
- `progress_percent` (number): How far through it the user is, 0 to 100
- `release_date` (text): When it was first released (UTC)
- `runtime_minutes` (number): How long it runs, in minutes
- `season_number` (number): For an episode, its season; 0 otherwise
- `show_id` (text): For an episode, its show's ID
- `show_name` (text): For an episode, its show
- `size` (number): Its file's size in bytes
- `studios` (list): Its studios
- `tagline` (text): Its tagline
- `tags` (list): Its tags
- `tmdb_id` (text): Its TMDb ID, when Emby has one
- `type` (text): What it is, as Emby names it: Movie, Series, Episode, MusicAlbum, Audio (a song), MusicArtist, BoxSet (a collection), Playlist and so on
- `web_url` (text): A link to it in Emby
- `year` (number): The year it came out; 0 when Emby doesn't know

**Example output**

```json
{
  "age_rating": "PG",
  "album": "",
  "album_artist": "",
  "artists": [],
  "child_count": 0,
  "community_rating": 7.4,
  "container": "mp4",
  "date_added": "2026-11-12T22:36:10Z",
  "episode_number": 0,
  "favourite": true,
  "genres": [
    "Drama",
    "Mystery"
  ],
  "id": "12",
  "imdb_id": "tt0111161",
  "last_played_at": "",
  "name": "Harbor Lights",
  "overview": "A lighthouse keeper's last winter.",
  "path": "/media/movies/Harbor Lights (2019)/Harbor Lights (2019).mp4",
  "people": [
    {
      "name": "Ada Lovell",
      "role": "The keeper",
      "type": "Actor"
    },
    {
      "name": "June Okafor",
      "role": "",
      "type": "Director"
    }
  ],
  "play_count": 0,
  "played": false,
  "progress_percent": 0.0,
  "release_date": "2019-03-08T00:00:00Z",
  "runtime_minutes": 104.0,
  "season_number": 0,
  "show_id": "",
  "show_name": "",
  "size": 1482031104,
  "studios": [
    "Northlight Pictures"
  ],
  "tagline": "Keep the light on.",
  "tags": [
    "family-night"
  ],
  "tmdb_id": "278",
  "type": "Movie",
  "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=12&serverId=c82de17ac3364560b5f0d5371f9d82d6",
  "year": 2019
}
```

### Get server info

Get the server's name, version, whether an update or restart is waiting, and how many films, shows, episodes, albums and songs it has.

**Inputs**: None.

**Outputs**

- `album_count` (number): How many albums
- `episode_count` (number): How many episodes
- `id` (text): The server's ID
- `local_address` (text): Its address on the home network, when Emby knows it
- `movie_count` (number): How many movies it has
- `name` (text): Its name
- `operating_system` (text): What it runs on
- `remote_address` (text): Its address from outside, when remote access is set up
- `restart_needed` (true/false): Whether it needs a restart, such as after a plugin update
- `show_count` (number): How many shows
- `song_count` (number): How many songs
- `update_available` (true/false): Whether a newer Emby Server is waiting
- `version` (text): Its Emby Server version

**Example output**

```json
{
  "album_count": 96,
  "episode_count": 1840,
  "id": "c82de17ac3364560b5f0d5371f9d82d6",
  "local_address": "http://192.168.1.20:8096",
  "movie_count": 412,
  "name": "Living room",
  "operating_system": "Linux",
  "remote_address": "https://emby.example.com",
  "restart_needed": false,
  "show_count": 37,
  "song_count": 1103,
  "update_available": false,
  "version": "4.10.2.0"
}
```

### List activity

Read Emby's activity log, newest first: who signed in or failed to, what was played, users added and removed, plugin and server updates.

**Inputs**

- Type (`activity_type`, text): Only entries of this type. One of: `any` (Anything), `playback.start` (Playback started), `playback.stop` (Playback stopped), `user.authenticated` (Signed in), `user.authenticationfailed` (Sign-in failed), `user.lockedout` (User locked out), `user.created` (User created), `user.deleted` (User deleted), `user.passwordchanged` (Password changed), `user.policyupdated` (User's access changed), and 7 more. Default: `any`.
- Since (`since`, date and time): Only entries from this date and time on.
- Results (`limit`, number): How many to return, up to 200. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many
- `entries` (list): The entries, newest first

**Example output**

```json
{
  "count": 1,
  "entries": [
    {
      "date": "2026-11-14T21:16:00Z",
      "id": "11",
      "item_id": "12",
      "name": "sam is playing Harbor Lights on Chrome Windows",
      "overview": "",
      "severity": "Info",
      "type": "playback.start"
    }
  ]
}
```

### List collection items

List what is in a collection.

**Inputs**

- Collection (`collection`, text, required): The collection, by name or ID, or one an earlier step made.
- Results (`limit`, number): How many to return, up to 200. Defaults to 25. From 1 to 200.

**Outputs**

- `collection_id` (text): The collection's ID
- `collection_name` (text): Its name
- `count` (number): How many
- `items` (list): What is in it

**Example output**

```json
{
  "collection_id": "48",
  "collection_name": "Harbor films",
  "count": 1,
  "items": [
    {
      "age_rating": "PG",
      "album": "",
      "album_artist": "",
      "artists": [],
      "community_rating": 7.4,
      "date_added": "2026-11-12T22:36:10Z",
      "episode_number": 0,
      "favourite": true,
      "genres": [
        "Drama",
        "Mystery"
      ],
      "id": "12",
      "imdb_id": "tt0111161",
      "last_played_at": "",
      "name": "Harbor Lights",
      "overview": "A lighthouse keeper's last winter.",
      "path": "/media/movies/Harbor Lights (2019)/Harbor Lights (2019).mp4",
      "play_count": 0,
      "played": false,
      "progress_percent": 0.0,
      "release_date": "2019-03-08T00:00:00Z",
      "runtime_minutes": 104.0,
      "season_number": 0,
      "show_id": "",
      "show_name": "",
      "tags": [
        "family-night"
      ],
      "tmdb_id": "278",
      "type": "Movie",
      "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=12&serverId=c82de17ac3364560b5f0d5371f9d82d6",
      "year": 2019
    }
  ]
}
```

### List collections

List the server's collections, such as a film series kept together.

**Inputs**: None.

**Outputs**

- `collections` (list): The collections, by name
- `count` (number): How many

**Example output**

```json
{
  "collections": [
    {
      "created_at": "2026-11-12T22:36:10Z",
      "id": "48",
      "name": "Harbor films",
      "overview": "",
      "runtime_minutes": 0.0,
      "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=48&serverId=c82de17ac3364560b5f0d5371f9d82d6"
    }
  ],
  "count": 1
}
```

### List continue watching

List what a user is partway through, as Emby's Continue Watching row shows it, with how far they got.

**Inputs**

- User (`user`, text): Whose viewing this is about, by name or ID. Leave blank when the server has one user.
- What (`media`, text): Video, audio (such as audiobooks) or both. One of: `video`, `audio`, `all` (Both). Default: `video`.
- Results (`limit`, number): How many to return, up to 200. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many
- `items` (list): The items, in Emby's order
- `user_name` (text): Whose they are

**Example output**

```json
{
  "count": 1,
  "items": [
    {
      "age_rating": "PG",
      "album": "",
      "album_artist": "",
      "artists": [],
      "community_rating": 7.4,
      "date_added": "2026-11-12T22:36:10Z",
      "episode_number": 1,
      "favourite": false,
      "genres": [
        "Drama"
      ],
      "id": "27",
      "imdb_id": "",
      "last_played_at": "",
      "name": "The Lamplighter",
      "overview": "A stranger moves in at number nine.",
      "path": "/media/tv/Lantern Street/Season 01/Lantern Street - S01E01.mp4",
      "play_count": 0,
      "played": false,
      "progress_percent": 41.5,
      "release_date": "2024-09-02T00:00:00Z",
      "runtime_minutes": 42.0,
      "season_number": 1,
      "show_id": "23",
      "show_name": "Lantern Street",
      "tags": [],
      "tmdb_id": "",
      "type": "Episode",
      "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=27&serverId=c82de17ac3364560b5f0d5371f9d82d6",
      "year": 2024
    }
  ],
  "user_name": "sam"
}
```

### List devices

List the devices and apps that have signed in to Emby, with who last used each and when.

**Inputs**: None.

**Outputs**

- `count` (number): How many
- `devices` (list): The devices that have signed in

**Example output**

```json
{
  "count": 1,
  "devices": [
    {
      "app": "Emby Web",
      "app_version": "4.10.2.0",
      "id": "4",
      "last_activity_at": "2026-11-14T21:40:00Z",
      "last_user_id": "b3f34c08a38848c5818c168153ff70c2",
      "last_user_name": "sam",
      "name": "Chrome Windows"
    }
  ]
}
```

### List libraries

List the server's libraries, with what each holds and the folders it reads.

**Inputs**: None.

**Outputs**

- `count` (number): How many
- `libraries` (list): The server's libraries

**Example output**

```json
{
  "count": 2,
  "libraries": [
    {
      "folders": [
        "/media/movies"
      ],
      "id": "3",
      "name": "Movies",
      "type": "Movies",
      "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=3&serverId=c82de17ac3364560b5f0d5371f9d82d6"
    },
    {
      "folders": [
        "/media/tv"
      ],
      "id": "5",
      "name": "TV Shows",
      "type": "Shows",
      "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=5&serverId=c82de17ac3364560b5f0d5371f9d82d6"
    }
  ]
}
```

### List next up

List the next episode of each show a user is watching, as Emby's Next Up row shows it.

**Inputs**

- User (`user`, text): Whose viewing this is about, by name or ID. Leave blank when the server has one user.
- Show (`show`, text): Only this show: its exact name, its link from Emby or its ID. Leave blank for every show.
- Results (`limit`, number): How many to return, up to 200. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many
- `items` (list): The items, in Emby's order
- `user_name` (text): Whose they are

**Example output**

```json
{
  "count": 1,
  "items": [
    {
      "age_rating": "PG",
      "album": "",
      "album_artist": "",
      "artists": [],
      "community_rating": 7.4,
      "date_added": "2026-11-12T22:36:10Z",
      "episode_number": 1,
      "favourite": false,
      "genres": [
        "Drama"
      ],
      "id": "27",
      "imdb_id": "",
      "last_played_at": "",
      "name": "The Lamplighter",
      "overview": "A stranger moves in at number nine.",
      "path": "/media/tv/Lantern Street/Season 01/Lantern Street - S01E01.mp4",
      "play_count": 0,
      "played": false,
      "progress_percent": 41.5,
      "release_date": "2024-09-02T00:00:00Z",
      "runtime_minutes": 42.0,
      "season_number": 1,
      "show_id": "23",
      "show_name": "Lantern Street",
      "tags": [],
      "tmdb_id": "",
      "type": "Episode",
      "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=27&serverId=c82de17ac3364560b5f0d5371f9d82d6",
      "year": 2024
    }
  ],
  "user_name": "sam"
}
```

### List playlist items

List what is in a playlist, in its order.

**Inputs**

- Playlist (`playlist`, text, required): The playlist, by name or ID, or one an earlier step made.
- Results (`limit`, number): How many to return, up to 200. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many
- `items` (list): What is in it, in order
- `playlist_id` (text): The playlist's ID
- `playlist_name` (text): Its name

**Example output**

```json
{
  "count": 1,
  "items": [
    {
      "age_rating": "PG",
      "album": "",
      "album_artist": "",
      "artists": [],
      "community_rating": 7.4,
      "date_added": "2026-11-12T22:36:10Z",
      "episode_number": 0,
      "favourite": true,
      "genres": [
        "Drama",
        "Mystery"
      ],
      "id": "12",
      "imdb_id": "tt0111161",
      "last_played_at": "",
      "name": "Harbor Lights",
      "overview": "A lighthouse keeper's last winter.",
      "path": "/media/movies/Harbor Lights (2019)/Harbor Lights (2019).mp4",
      "play_count": 0,
      "played": false,
      "progress_percent": 0.0,
      "release_date": "2019-03-08T00:00:00Z",
      "runtime_minutes": 104.0,
      "season_number": 0,
      "show_id": "",
      "show_name": "",
      "tags": [
        "family-night"
      ],
      "tmdb_id": "278",
      "type": "Movie",
      "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=12&serverId=c82de17ac3364560b5f0d5371f9d82d6",
      "year": 2019
    }
  ],
  "playlist_id": "45",
  "playlist_name": "Friday night"
}
```

### List playlists

List the server's playlists.

**Inputs**: None.

**Outputs**

- `count` (number): How many
- `playlists` (list): The playlists, by name

**Example output**

```json
{
  "count": 1,
  "playlists": [
    {
      "created_at": "2026-11-12T22:36:10Z",
      "id": "45",
      "name": "Friday night",
      "overview": "",
      "runtime_minutes": 208.0,
      "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=45&serverId=c82de17ac3364560b5f0d5371f9d82d6"
    }
  ]
}
```

### List recently added

List what was added to Emby lately, newest first: films, episodes and albums, or one kind, in every library or one.

**Inputs**

- Kind (`item_type`, text): Only this kind of item. Any lists films, episodes and albums. One of: `any`, `movies`, `shows`, `episodes`, `albums`, `artists`, `songs`, `music_videos` (Music videos), `other_videos` (Home videos), `collections`, and 4 more. Default: `any`.
- Library (`library`, text): Only this library, by name or ID. Leave blank for all of them.
- Added after (`added_after`, date and time): Only items added to Emby after this date and time.
- User (`user`, text): Whose played and favourite marks to include, by name or ID. Leave blank for none.
- Results (`limit`, number): How many to return, up to 200. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many
- `items` (list): The items, newest added first

**Example output**

```json
{
  "count": 2,
  "items": [
    {
      "age_rating": "PG",
      "album": "",
      "album_artist": "",
      "artists": [],
      "community_rating": 7.4,
      "date_added": "2026-11-12T22:36:10Z",
      "episode_number": 1,
      "favourite": false,
      "genres": [
        "Drama"
      ],
      "id": "27",
      "imdb_id": "",
      "last_played_at": "",
      "name": "The Lamplighter",
      "overview": "A stranger moves in at number nine.",
      "path": "/media/tv/Lantern Street/Season 01/Lantern Street - S01E01.mp4",
      "play_count": 0,
      "played": false,
      "progress_percent": 0.0,
      "release_date": "2024-09-02T00:00:00Z",
      "runtime_minutes": 42.0,
      "season_number": 1,
      "show_id": "23",
      "show_name": "Lantern Street",
      "tags": [],
      "tmdb_id": "",
      "type": "Episode",
      "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=27&serverId=c82de17ac3364560b5f0d5371f9d82d6",
      "year": 2024
    },
    {
      "age_rating": "PG",
      "album": "",
      "album_artist": "",
      "artists": [],
      "community_rating": 7.4,
      "date_added": "2026-11-12T22:36:10Z",
      "episode_number": 0,
      "favourite": true,
      "genres": [
        "Drama",
        "Mystery"
      ],
      "id": "12",
      "imdb_id": "tt0111161",
      "last_played_at": "",
      "name": "Harbor Lights",
      "overview": "A lighthouse keeper's last winter.",
      "path": "/media/movies/Harbor Lights (2019)/Harbor Lights (2019).mp4",
      "play_count": 0,
      "played": false,
      "progress_percent": 0.0,
      "release_date": "2019-03-08T00:00:00Z",
      "runtime_minutes": 104.0,
      "season_number": 0,
      "show_id": "",
      "show_name": "",
      "tags": [
        "family-night"
      ],
      "tmdb_id": "278",
      "type": "Movie",
      "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=12&serverId=c82de17ac3364560b5f0d5371f9d82d6",
      "year": 2019
    }
  ]
}
```

### List scheduled tasks

List Emby's scheduled tasks, such as Scan media library, with whether each is running and how its last run ended.

**Inputs**

- Include hidden (`include_hidden`, true/false): Also list the housekeeping tasks Emby hides from its Scheduled Tasks page. Default: `false`.

**Outputs**

- `count` (number): How many
- `tasks` (list): The scheduled tasks

**Example output**

```json
{
  "count": 1,
  "tasks": [
    {
      "category": "Library",
      "description": "Scans your media library for new files and refreshes metadata.",
      "id": "6330ee8fb4a957f33981f89aa78b030f",
      "is_hidden": false,
      "key": "RefreshLibrary",
      "last_error": "",
      "last_finished_at": "2026-11-14T03:02:41Z",
      "last_started_at": "2026-11-14T03:00:00Z",
      "last_status": "Completed",
      "name": "Scan media library",
      "progress_percent": 0.0,
      "state": "Idle"
    }
  ]
}
```

### List sessions

List the apps and devices signed in to Emby and what each is playing now: who is watching what, how far in, and whether it is paused.

**Inputs**

- Playing only (`playing_only`, true/false): Only sessions that are playing something. Default: `false`.
- User (`user`, text): Only this user's sessions, by name or ID. Leave blank for everyone's.

**Outputs**

- `count` (number): How many
- `playing_count` (number): How many of them are playing something
- `sessions` (list): The sessions: those that can be controlled first, then the most recently active

**Example output**

```json
{
  "count": 1,
  "playing_count": 1,
  "sessions": [
    {
      "app": "Emby Web",
      "app_version": "4.10.2.0",
      "can_be_controlled": true,
      "device": "Chrome Windows",
      "device_id": "a0ab28af-5644-4c5a-81b1-0db2d57ac34f",
      "id": "dd4f087a76f7d20040016d1db9e770f0",
      "is_paused": false,
      "is_playing": true,
      "item_id": "12",
      "item_name": "Harbor Lights",
      "item_type": "Movie",
      "last_activity_at": "2026-11-14T21:40:00Z",
      "play_method": "DirectStream",
      "position_minutes": 23.7,
      "runtime_minutes": 104.0,
      "show_name": "",
      "user_id": "b3f34c08a38848c5818c168153ff70c2",
      "user_name": "sam"
    }
  ]
}
```

### List users

List the server's users, with whether each is an administrator or disabled and when they were last active.

**Inputs**: None.

**Outputs**

- `count` (number): How many
- `users` (list): The server's users

**Example output**

```json
{
  "count": 2,
  "users": [
    {
      "all_libraries": true,
      "can_delete": false,
      "can_play": true,
      "created_at": "2026-11-12T22:36:09Z",
      "has_password": true,
      "id": "b3f34c08a38848c5818c168153ff70c2",
      "is_admin": true,
      "is_disabled": false,
      "is_hidden": false,
      "last_activity_at": "2026-11-14T21:40:00Z",
      "last_login_at": "2026-11-14T19:02:11Z",
      "name": "admin",
      "remote_access": true
    },
    {
      "all_libraries": true,
      "can_delete": false,
      "can_play": true,
      "created_at": "2026-11-12T22:36:09Z",
      "has_password": true,
      "id": "b3f34c08a38848c5818c168153ff70c2",
      "is_admin": false,
      "is_disabled": false,
      "is_hidden": false,
      "last_activity_at": "2026-11-14T21:40:00Z",
      "last_login_at": "2026-11-14T19:02:11Z",
      "name": "sam",
      "remote_access": true
    }
  ]
}
```

### Mark as played

Mark a film, episode or song as played for a user; a show or album marks everything in it.

**Inputs**

- Item (`item`, text, required): The film, show, episode, song or album: its exact name, its link from Emby, or the ID an earlier step found, such as Search media.
- User (`user`, text): Whose viewing this is about, by name or ID. Leave blank when the server has one user.
- Played at (`played_at`, date and time): When they played it. Leave blank for now.

**Outputs**

- `favourite` (true/false): Whether it is now one of their favourites
- `id` (text): The item's ID
- `last_played_at` (text): When they last played it (UTC)
- `name` (text): Its title
- `play_count` (number): How many times they have played it
- `played` (true/false): Whether the user has now played it
- `type` (text): What it is, such as Movie
- `user_id` (text): The user's ID
- `user_name` (text): The user's name
- `web_url` (text): A link to it in Emby

**Example output**

```json
{
  "favourite": false,
  "id": "12",
  "last_played_at": "2026-11-12T22:36:10Z",
  "name": "Harbor Lights",
  "play_count": 1,
  "played": true,
  "type": "Movie",
  "user_id": "b3f34c08a38848c5818c168153ff70c2",
  "user_name": "sam",
  "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=12&serverId=c82de17ac3364560b5f0d5371f9d82d6"
}
```

### Mark as unplayed

Mark a film, episode or song as not played for a user, so it shows as new to them again.

**Inputs**

- Item (`item`, text, required): The film, show, episode, song or album: its exact name, its link from Emby, or the ID an earlier step found, such as Search media.
- User (`user`, text): Whose viewing this is about, by name or ID. Leave blank when the server has one user.

**Outputs**

- `favourite` (true/false): Whether it is now one of their favourites
- `id` (text): The item's ID
- `last_played_at` (text): When they last played it (UTC)
- `name` (text): Its title
- `play_count` (number): How many times they have played it
- `played` (true/false): Whether the user has now played it
- `type` (text): What it is, such as Movie
- `user_id` (text): The user's ID
- `user_name` (text): The user's name
- `web_url` (text): A link to it in Emby

**Example output**

```json
{
  "favourite": false,
  "id": "12",
  "last_played_at": "2026-11-12T22:36:10Z",
  "name": "Harbor Lights",
  "play_count": 1,
  "played": true,
  "type": "Movie",
  "user_id": "b3f34c08a38848c5818c168153ff70c2",
  "user_name": "sam",
  "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=12&serverId=c82de17ac3364560b5f0d5371f9d82d6"
}
```

### Play on a session

Have a player start playing a film, episode, song or several, now or after what it is playing.

**Inputs**

- Session (`session`, text, required): The player: a session from List sessions, or the name of a user or device that is signed in on one.
- Items (`items`, text, required): One or more films, episodes or songs: exact names, links from Emby or IDs from an earlier step, separated by commas.
- When (`play_mode`, text): Play it now, next, or at the end of the player's queue. One of: `play_now` (Play now), `play_next` (Play next), `play_last` (Add to the end of the queue). Default: `play_now`.

**Outputs**

- `count` (number): How many items
- `device` (text): The device's name
- `items` (list): What it was asked to play, in order
- `play_mode` (text): play_now, play_next or play_last
- `sent` (true/false): True once Emby has passed it on
- `session_id` (text): The session asked to play
- `user_name` (text): Who is signed in there

**Example output**

```json
{
  "count": 1,
  "device": "Chrome Windows",
  "items": [
    {
      "id": "12",
      "name": "Harbor Lights"
    }
  ],
  "play_mode": "play_now",
  "sent": true,
  "session_id": "dd4f087a76f7d20040016d1db9e770f0",
  "user_name": "sam"
}
```

### Refresh metadata

Have Emby look up an item's details and pictures again, as Refresh Metadata does. For a show or album, everything in it too.

**Inputs**

- Item (`item`, text, required): The film, show, episode, song or album: its exact name, its link from Emby, or the ID an earlier step found, such as Search media.
- Replace existing details (`replace_metadata`, true/false): Replace what Emby already has with what it finds. Off only fills in what is missing. Default: `false`.

**Outputs**

- `id` (text): The item's ID
- `name` (text): Its title
- `refreshing` (true/false): True once Emby has started the refresh
- `type` (text): What it is, such as Movie
- `web_url` (text): A link to it in Emby

**Example output**

```json
{
  "id": "12",
  "name": "Harbor Lights",
  "refreshing": true,
  "type": "Movie",
  "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=12&serverId=c82de17ac3364560b5f0d5371f9d82d6"
}
```

### Remove from collection

Take films or shows out of a collection. The media itself stays in Emby.

**Inputs**

- Collection (`collection`, text, required): The collection, by name or ID, or one an earlier step made.
- Items (`items`, text, required): One or more films, episodes or songs: exact names, links from Emby or IDs from an earlier step, separated by commas.

**Outputs**

- `count` (number): How many were removed
- `created_at` (text): When it was made (UTC)
- `id` (text): Its ID, for other Emby steps
- `name` (text): Its name
- `overview` (text): Its description
- `removed` (list): The items removed
- `runtime_minutes` (number): How long everything in it runs, in minutes
- `web_url` (text): A link to it in Emby

**Example output**

```json
{
  "count": 1,
  "created_at": "2026-11-12T22:36:10Z",
  "id": "48",
  "name": "Harbor films",
  "overview": "",
  "removed": [
    {
      "id": "12",
      "name": "Harbor Lights"
    }
  ],
  "runtime_minutes": 0.0,
  "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=48&serverId=c82de17ac3364560b5f0d5371f9d82d6"
}
```

### Remove from favourites

Take an item out of a user's favourites.

**Inputs**

- Item (`item`, text, required): The film, show, episode, song or album: its exact name, its link from Emby, or the ID an earlier step found, such as Search media.
- User (`user`, text): Whose viewing this is about, by name or ID. Leave blank when the server has one user.

**Outputs**

- `favourite` (true/false): Whether it is now one of their favourites
- `id` (text): The item's ID
- `last_played_at` (text): When they last played it (UTC)
- `name` (text): Its title
- `play_count` (number): How many times they have played it
- `played` (true/false): Whether the user has now played it
- `type` (text): What it is, such as Movie
- `user_id` (text): The user's ID
- `user_name` (text): The user's name
- `web_url` (text): A link to it in Emby

**Example output**

```json
{
  "favourite": false,
  "id": "12",
  "last_played_at": "2026-11-12T22:36:10Z",
  "name": "Harbor Lights",
  "play_count": 1,
  "played": true,
  "type": "Movie",
  "user_id": "b3f34c08a38848c5818c168153ff70c2",
  "user_name": "sam",
  "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=12&serverId=c82de17ac3364560b5f0d5371f9d82d6"
}
```

### Remove from playlist

Take films, episodes or songs out of a playlist. The media itself stays in Emby.

**Inputs**

- Playlist (`playlist`, text, required): The playlist, by name or ID, or one an earlier step made.
- Items (`items`, text, required): One or more films, episodes or songs: exact names, links from Emby or IDs from an earlier step, separated by commas.

**Outputs**

- `count` (number): How many were removed
- `created_at` (text): When it was made (UTC)
- `id` (text): Its ID, for other Emby steps
- `name` (text): Its name
- `overview` (text): Its description
- `removed` (list): The items removed
- `runtime_minutes` (number): How long everything in it runs, in minutes
- `web_url` (text): A link to it in Emby

**Example output**

```json
{
  "count": 1,
  "created_at": "2026-11-12T22:36:10Z",
  "id": "45",
  "name": "Friday night",
  "overview": "",
  "removed": [
    {
      "id": "12",
      "name": "Harbor Lights"
    }
  ],
  "runtime_minutes": 208.0,
  "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=45&serverId=c82de17ac3364560b5f0d5371f9d82d6"
}
```

### Run a scheduled task

Start one of Emby's scheduled tasks now, as its play button does. One already running is left to finish.

**Inputs**

- Task (`task`, text, required): The task, by name or ID, such as Scan media library.

**Outputs**

- `category` (text): Where Emby files it, such as Library
- `description` (text): What it does
- `id` (text): The task's ID
- `is_hidden` (true/false): Whether Emby hides it from its Scheduled Tasks page
- `key` (text): Emby's short name for it, such as RefreshLibrary
- `last_error` (text): What went wrong in its last run, if it failed
- `last_finished_at` (text): When its last run ended (UTC)
- `last_started_at` (text): When its last run started (UTC)
- `last_status` (text): How its last run ended: Completed, Failed, Cancelled or Aborted
- `name` (text): Its name, such as Scan media library
- `progress_percent` (number): How far through it is while running
- `started` (true/false): True when this step started it; false if it was running
- `state` (text): Idle, Running or Cancelling

**Example output**

```json
{
  "category": "Library",
  "description": "Scans your media library for new files and refreshes metadata.",
  "id": "6330ee8fb4a957f33981f89aa78b030f",
  "is_hidden": false,
  "key": "RefreshLibrary",
  "last_error": "",
  "last_finished_at": "2026-11-14T03:02:41Z",
  "last_started_at": "2026-11-14T03:00:00Z",
  "last_status": "Completed",
  "name": "Scan media library",
  "progress_percent": 0.0,
  "started": true,
  "state": "Running"
}
```

### Scan library

Have Emby look through its libraries' folders for new, changed and removed files, as Scan Library Files does, such as after a download lands.

**Inputs**

- Library (`library`, text): Only this library, by name or ID. Leave blank to scan them all.
- Wait for it (`wait`, true/false): Wait up to a minute for a scan of every library to finish. Off, or for one library, the step only starts it. Default: `true`.

**Outputs**

- `finished` (true/false): Whether the scan finished while the step waited
- `library_id` (text): The library scanned; empty for every library
- `library_name` (text): Its name; empty for every library
- `status` (text): finished, or started when it is still running

**Example output**

```json
{
  "finished": true,
  "library_id": "",
  "library_name": "",
  "status": "finished"
}
```

### Search media

Find films, shows, episodes, albums and songs: by words in the title, kind, library, genre, tag, year, when they were added, and whether a user has played them or made them a favourite.

**Inputs**

- Title contains (`search_text`, text): Words to look for in the title. Leave blank to list everything that fits the rest.
- Kind (`item_type`, text): Only this kind of item. One of: `any`, `movies`, `shows`, `episodes`, `albums`, `artists`, `songs`, `music_videos` (Music videos), `other_videos` (Home videos), `collections`, and 4 more. Default: `any`.
- Library (`library`, text): Only this library, by name or ID. Leave blank for all of them.
- Genres (`genres`, text): Only items of any of these genres, separated by commas.
- Tags (`tags`, text): Only items with any of these tags, separated by commas.
- From year (`year_from`, number): Only items from this year on. From 1800 to 2200.
- To year (`year_to`, number): Only items up to this year. From 1800 to 2200.
- Played (`played`, text): Only items the user has played, or hasn't. Needs a user. One of: `any`, `unplayed`, `played`. Default: `any`.
- Favourites only (`favourites_only`, true/false): Only the user's favourites. Needs a user. Default: `false`.
- Added after (`added_after`, date and time): Only items added to Emby after this date and time.
- User (`user`, text): Whose played and favourite marks to use, by name or ID. Leave blank when the server has one user, or when neither matters.
- Sort by (`sort`, text): The order to list them in. One of: `name`, `recently_added` (Newest added first), `newest` (Newest released first), `oldest` (Oldest released first), `top_rated` (Top rated), `recently_played` (Most recently played), `most_played` (Most played), `shortest` (Shortest first), `random`. Default: `name`.
- Results (`limit`, number): How many to return, up to 200. Defaults to 25. From 1 to 200.
- Page (`page`, number): Which page of results: 2 for the next lot after the first, and so on. From 1 to 10000.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): Whether there are more pages
- `items` (list): The items found, in the order asked for
- `page` (number): Which page this is
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 2,
  "has_more": false,
  "items": [
    {
      "age_rating": "PG",
      "album": "",
      "album_artist": "",
      "artists": [],
      "community_rating": 7.4,
      "date_added": "2026-11-12T22:36:10Z",
      "episode_number": 0,
      "favourite": true,
      "genres": [
        "Drama",
        "Mystery"
      ],
      "id": "12",
      "imdb_id": "tt0111161",
      "last_played_at": "",
      "name": "Harbor Lights",
      "overview": "A lighthouse keeper's last winter.",
      "path": "/media/movies/Harbor Lights (2019)/Harbor Lights (2019).mp4",
      "play_count": 0,
      "played": false,
      "progress_percent": 0.0,
      "release_date": "2019-03-08T00:00:00Z",
      "runtime_minutes": 104.0,
      "season_number": 0,
      "show_id": "",
      "show_name": "",
      "tags": [
        "family-night"
      ],
      "tmdb_id": "278",
      "type": "Movie",
      "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=12&serverId=c82de17ac3364560b5f0d5371f9d82d6",
      "year": 2019
    },
    {
      "age_rating": "PG",
      "album": "",
      "album_artist": "",
      "artists": [],
      "community_rating": 7.4,
      "date_added": "2026-11-12T22:36:10Z",
      "episode_number": 1,
      "favourite": false,
      "genres": [
        "Drama"
      ],
      "id": "27",
      "imdb_id": "",
      "last_played_at": "",
      "name": "The Lamplighter",
      "overview": "A stranger moves in at number nine.",
      "path": "/media/tv/Lantern Street/Season 01/Lantern Street - S01E01.mp4",
      "play_count": 0,
      "played": false,
      "progress_percent": 0.0,
      "release_date": "2024-09-02T00:00:00Z",
      "runtime_minutes": 42.0,
      "season_number": 1,
      "show_id": "23",
      "show_name": "Lantern Street",
      "tags": [],
      "tmdb_id": "",
      "type": "Episode",
      "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=27&serverId=c82de17ac3364560b5f0d5371f9d82d6",
      "year": 2024
    }
  ],
  "page": 1,
  "total": 2
}
```

### Send message to a session

Show a message on a player's screen, such as that dinner is ready or the server is going down for maintenance.

**Inputs**

- Session (`session`, text, required): The player: a session from List sessions, or the name of a user or device that is signed in on one.
- Message (`text`, text, required): What to say.
- Heading (`header`, text): A short heading above it. Defaults to Message.
- Show for (seconds) (`timeout_seconds`, number): How long it stays up. Defaults to 10. From 1 to 300.

**Outputs**

- `app` (text): The app, such as Emby Web or Emby for Android
- `app_version` (text): The app's version
- `can_be_controlled` (true/false): Whether it takes messages and playback commands
- `device` (text): The device's name
- `device_id` (text): The device's own ID
- `id` (text): The session's ID, for Send message, Control playback and Play
- `is_paused` (true/false): Whether what it is playing is paused
- `is_playing` (true/false): Whether it is playing something (paused counts)
- `item_id` (text): The ID of what is playing; empty when idle
- `item_name` (text): The title of what is playing
- `item_type` (text): What is playing, such as Movie or Episode
- `last_activity_at` (text): When it was last heard from (UTC)
- `play_method` (text): DirectPlay, DirectStream or Transcode
- `position_minutes` (number): How far in it is, in minutes
- `runtime_minutes` (number): How long what is playing runs, in minutes
- `sent` (true/false): True once Emby has passed it on
- `show_name` (text): For an episode, its show
- `user_id` (text): The ID of the user signed in
- `user_name` (text): Their name

**Example output**

```json
{
  "app": "Emby Web",
  "app_version": "4.10.2.0",
  "can_be_controlled": true,
  "device": "Chrome Windows",
  "device_id": "a0ab28af-5644-4c5a-81b1-0db2d57ac34f",
  "id": "dd4f087a76f7d20040016d1db9e770f0",
  "is_paused": false,
  "is_playing": true,
  "item_id": "12",
  "item_name": "Harbor Lights",
  "item_type": "Movie",
  "last_activity_at": "2026-11-14T21:40:00Z",
  "play_method": "DirectStream",
  "position_minutes": 23.7,
  "runtime_minutes": 104.0,
  "sent": true,
  "show_name": "",
  "user_id": "b3f34c08a38848c5818c168153ff70c2",
  "user_name": "sam"
}
```

### Update an item

Change an item's name, overview, genres, tags or year. Only the fields filled in change; genres and tags given replace the ones it had.

**Inputs**

- Item (`item`, text, required): The film, show, episode, song or album: its exact name, its link from Emby, or the ID an earlier step found, such as Search media.
- Name (`name`, text): Its new title.
- Overview (`overview`, text): Its new summary.
- Genres (`genres`, text): Its genres, separated by commas. They replace the ones it has.
- Tags (`tags`, text): Its tags, separated by commas. They replace the ones it has.
- Year (`year`, number): The year it came out. From 1800 to 2200.

**Outputs**

- `age_rating` (text): Its age rating, such as PG-13
- `album` (text): For a song, its album
- `album_artist` (text): For a song or album, the album's artist
- `artists` (list): For a song or album, its artists
- `community_rating` (number): Its rating out of 10; 0 for none
- `date_added` (text): When it was added to Emby (UTC)
- `episode_number` (number): For an episode, its number; 0 otherwise
- `favourite` (true/false): Whether it is one of the user's favourites; false when no user was given
- `genres` (list): Its genres
- `id` (text): The item's ID, for other Emby steps
- `imdb_id` (text): Its IMDb ID, when Emby has one
- `last_played_at` (text): When the user last played it (UTC)
- `name` (text): Its title
- `overview` (text): Its summary
- `path` (text): Where its file or folder is on the server
- `play_count` (number): How many times the user has played it
- `played` (true/false): Whether the user has played it; false when no user was given
- `progress_percent` (number): How far through it the user is, 0 to 100
- `release_date` (text): When it was first released (UTC)
- `runtime_minutes` (number): How long it runs, in minutes
- `season_number` (number): For an episode, its season; 0 otherwise
- `show_id` (text): For an episode, its show's ID
- `show_name` (text): For an episode, its show
- `tags` (list): Its tags
- `tmdb_id` (text): Its TMDb ID, when Emby has one
- `type` (text): What it is, as Emby names it: Movie, Series, Episode, MusicAlbum, Audio (a song), MusicArtist, BoxSet (a collection), Playlist and so on
- `web_url` (text): A link to it in Emby
- `year` (number): The year it came out; 0 when Emby doesn't know

**Example output**

```json
{
  "age_rating": "PG",
  "album": "",
  "album_artist": "",
  "artists": [],
  "community_rating": 7.4,
  "date_added": "2026-11-12T22:36:10Z",
  "episode_number": 0,
  "favourite": true,
  "genres": [
    "Drama",
    "Mystery"
  ],
  "id": "12",
  "imdb_id": "tt0111161",
  "last_played_at": "",
  "name": "Harbor Lights",
  "overview": "A lighthouse keeper's last winter.",
  "path": "/media/movies/Harbor Lights (2019)/Harbor Lights (2019).mp4",
  "play_count": 0,
  "played": false,
  "progress_percent": 0.0,
  "release_date": "2019-03-08T00:00:00Z",
  "runtime_minutes": 104.0,
  "season_number": 0,
  "show_id": "",
  "show_name": "",
  "tags": [
    "family-night"
  ],
  "tmdb_id": "278",
  "type": "Movie",
  "web_url": "http://192.168.1.20:8096/web/index.html#!/item?id=12&serverId=c82de17ac3364560b5f0d5371f9d82d6",
  "year": 2019
}
```
