# Plex

> Browse Plex libraries, media, playlists, playback history and active sessions; refresh metadata and mark watched items.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/plex

## Actions

### Delete playlist

Delete playlist.

**Inputs**

- Playlist (`playlist_id`, text, required): Choose the playlist or use an ID from a previous step.

**Outputs**

- `data` (null): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": null,
  "has_more": false,
  "next_cursor": null
}
```

### Get identity

Get identity.

**Inputs**: None.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "claimed": false,
      "machineIdentifier": "example",
      "size": 0,
      "version": "example"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get item

Get item.

**Inputs**

- Item ID (`item_id`, text, required): Item id.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "Metadata": [],
      "size": 0,
      "totalSize": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get playlist

Get playlist.

**Inputs**

- Playlist (`playlist_id`, text, required): Choose the playlist or use an ID from a previous step.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "Metadata": [],
      "size": 0,
      "totalSize": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get server

Get server.

**Inputs**: None.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "friendlyName": "example",
      "machineIdentifier": "example",
      "size": 0,
      "version": "example"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List clients

List clients.

**Inputs**: None.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "Server": [],
      "size": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List item children

List item children.

**Inputs**

- Item ID (`item_id`, text, required): Item id.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "Metadata": [],
      "size": 0,
      "totalSize": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List item leaves

List item leaves.

**Inputs**

- Item ID (`item_id`, text, required): Item id.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "Metadata": [],
      "size": 0,
      "totalSize": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List libraries

List libraries.

**Inputs**: None.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "Directory": [],
      "size": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List library items

List library items. Returns one page; use next_cursor to continue.

**Inputs**

- Library (`library_id`, text, required): Choose the library or use an ID from a previous step.
- Starting position (`offset`, number): Number of records to skip. Leave empty to start at the beginning. At least 0.
- Results per page (`limit`, number): Maximum records in this page. Leave empty for the service default. From 1 to 200.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "Metadata": [],
      "size": 0,
      "totalSize": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List on deck

List on deck. Returns one page; use next_cursor to continue.

**Inputs**

- Starting position (`offset`, number): Number of records to skip. Leave empty to start at the beginning. At least 0.
- Results per page (`limit`, number): Maximum records in this page. Leave empty for the service default. From 1 to 200.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "Metadata": [],
      "size": 0,
      "totalSize": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List play history

List play history. Returns one page; use next_cursor to continue.

**Inputs**

- Starting position (`offset`, number): Number of records to skip. Leave empty to start at the beginning. At least 0.
- Results per page (`limit`, number): Maximum records in this page. Leave empty for the service default. From 1 to 200.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "Metadata": [],
      "size": 0,
      "totalSize": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List playlist items

List playlist items.

**Inputs**

- Playlist (`playlist_id`, text, required): Choose the playlist or use an ID from a previous step.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "Metadata": [],
      "size": 0,
      "totalSize": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List playlists

List playlists. Returns one page; use next_cursor to continue.

**Inputs**

- Starting position (`offset`, number): Number of records to skip. Leave empty to start at the beginning. At least 0.
- Results per page (`limit`, number): Maximum records in this page. Leave empty for the service default. From 1 to 200.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "Metadata": [],
      "size": 0,
      "totalSize": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List recently added

List recently added. Returns one page; use next_cursor to continue.

**Inputs**

- Starting position (`offset`, number): Number of records to skip. Leave empty to start at the beginning. At least 0.
- Results per page (`limit`, number): Maximum records in this page. Leave empty for the service default. From 1 to 200.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "Metadata": [],
      "size": 0,
      "totalSize": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List sessions

List sessions.

**Inputs**: None.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "MediaContainer": {
      "Metadata": [],
      "size": 0,
      "totalSize": 0
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Mark unwatched

Mark unwatched.

**Inputs**

- Item ID (`item_id`, text, required): Item id.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Mark watched

Mark watched.

**Inputs**

- Item ID (`item_id`, text, required): Item id.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Refresh item

Refresh item.

**Inputs**

- Item ID (`item_id`, text, required): Item id.

**Outputs**

- `data` (null): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": null,
  "has_more": false,
  "next_cursor": null
}
```

### Refresh library

Refresh library.

**Inputs**

- Library (`library_id`, text, required): Choose the library or use an ID from a previous step.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```
