> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# spotify-library

> Spotify Library - saved albums, tracks, shows, episodes, audiobooks, and followed artists

**Server path:** `/spotify-library` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                                              | Description                  |
| ----------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| [`spotify_library_check_library_contains`](#spotify_library_check_library_contains)                               | Check User's Saved Items     |
| [`spotify_library_create_playlist`](#spotify_library_create_playlist)                                             | Create Playlist              |
| [`spotify_library_get_a_list_of_current_users_playlists`](#spotify_library_get_a_list_of_current_users_playlists) | Get Current User's Playlists |
| [`spotify_library_get_current_users_profile`](#spotify_library_get_current_users_profile)                         | Get Current User's Profile   |
| [`spotify_library_get_followed`](#spotify_library_get_followed)                                                   | Get Followed Artists         |
| [`spotify_library_get_users_saved_albums`](#spotify_library_get_users_saved_albums)                               | Get User's Saved Albums      |
| [`spotify_library_get_users_saved_audiobooks`](#spotify_library_get_users_saved_audiobooks)                       | Get User's Saved Audiobooks  |
| [`spotify_library_get_users_saved_episodes`](#spotify_library_get_users_saved_episodes)                           | Get User's Saved Episodes    |
| [`spotify_library_get_users_saved_shows`](#spotify_library_get_users_saved_shows)                                 | Get User's Saved Shows       |
| [`spotify_library_get_users_saved_tracks`](#spotify_library_get_users_saved_tracks)                               | Get User's Saved Tracks      |
| [`spotify_library_get_users_top_artists_and_tracks`](#spotify_library_get_users_top_artists_and_tracks)           | Get User's Top Items         |
| [`spotify_library_remove_library_items`](#spotify_library_remove_library_items)                                   | Remove Items from Library    |
| [`spotify_library_save_library_items`](#spotify_library_save_library_items)                                       | Save Items to Library        |

***

## spotify\_library\_check\_library\_contains

Check User's Saved Items

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                     |
| --------- | ------ | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uris`    | string | Yes      | —       | A comma-separated list of Spotify URIs. Maximum: 40 URIs.  Supported URI types: - `spotify:track:{id}` - `spotify:album:{id}` - `spotify:episode:{id}` - `spotify:show:{id}` - `spotify:audiobook:{id}` - `spotify:artist:{id}` - `spotify:user:{id}` - `spotify:playlist:{id}` |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "uris": {
        "type": "string",
        "description": "A comma-separated list of [Spotify URIs](/documentation/web-api/concepts/spotify-uris-ids). Maximum: 40 URIs.  Supported URI types: - `spotify:track:{id}` - `spotify:album:{id}` - `spotify:episode:{id}` - `spotify:show:{id}` - `spotify:audiobook:{id}` - `spotify:artist:{id}` - `spotify:user:{id}` - `spotify:playlist:{id}`"
      }
    },
    "required": [
      "PCID",
      "uris"
    ]
  }
  ```
</Expandable>

***

## spotify\_library\_create\_playlist

Create Playlist

**Parameters:**

| Parameter       | Type    | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                       |
| --------------- | ------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `collaborative` | boolean | No       | —       | Defaults to `false`. If `true` the playlist will be collaborative. ***Note**: to create a collaborative playlist you must also set `public` to `false`. To create collaborative playlists you must have granted `playlist-modify-private` and `playlist-modify-public` scopes.*                                                                                   |
| `description`   | string  | No       | —       | value for playlist description as displayed in Spotify Clients and in the Web API.                                                                                                                                                                                                                                                                                |
| `name`          | string  | Yes      | —       | The name for the new playlist, for example `"Your Coolest Playlist"`. This name does not need to be unique; a user may have several playlists with the same name.                                                                                                                                                                                                 |
| `public`        | boolean | No       | —       | Defaults to `true`. The playlist's public/private status (if it should be added to the user's profile or not): `true` the playlist will be public, `false` the playlist will be private. To be able to create private playlists, the user must have granted the `playlist-modify-private` scope. For more about public/private status, see Working with Playlists |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "collaborative": {
        "type": "boolean",
        "description": "Defaults to `false`. If `true` the playlist will be collaborative. _**Note**: to create a collaborative playlist you must also set `public` to `false`. To create collaborative playlists you must have granted `playlist-modify-private` and `playlist-modify-public` [scopes](/documentation/web-api/concepts/scopes/#list-of-scopes)._"
      },
      "description": {
        "type": "string",
        "description": "value for playlist description as displayed in Spotify Clients and in the Web API."
      },
      "name": {
        "type": "string",
        "description": "The name for the new playlist, for example `\"Your Coolest Playlist\"`. This name does not need to be unique; a user may have several playlists with the same name."
      },
      "public": {
        "type": "boolean",
        "description": "Defaults to `true`. The playlist's public/private status (if it should be added to the user's profile or not): `true` the playlist will be public, `false` the playlist will be private. To be able to create private playlists, the user must have granted the `playlist-modify-private` [scope](/documentation/web-api/concepts/scopes/#list-of-scopes). For more about public/private status, see [Working with Playlists](/documentation/web-api/concepts/playlists)"
      }
    },
    "required": [
      "PCID",
      "name"
    ]
  }
  ```
</Expandable>

***

## spotify\_library\_get\_a\_list\_of\_current\_users\_playlists

Get Current User's Playlists

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                                                                                             |
| --------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer | No       | —       | The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.                                                                            |
| `offset`  | integer | No       | —       | 'The index of the first playlist to return. Default: 0 (the first object). Maximum offset: 100.000. Use with `limit` to get the next set of playlists.' |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "limit": {
        "type": "integer",
        "description": "The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50."
      },
      "offset": {
        "type": "integer",
        "description": "'The index of the first playlist to return. Default: 0 (the first object). Maximum offset: 100.000\\. Use with `limit` to get the next set of playlists.'"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## spotify\_library\_get\_current\_users\_profile

Get Current User's Profile

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## spotify\_library\_get\_followed

Get Followed Artists

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                  |
| --------- | ------- | -------- | ------- | ---------------------------------------------------------------------------- |
| `type`    | string  | Yes      | —       | The ID type: currently only `artist` is supported.                           |
| `after`   | string  | No       | —       | The last artist ID retrieved from the previous request.                      |
| `limit`   | integer | No       | —       | The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "type": {
        "type": "string",
        "description": "The ID type: currently only `artist` is supported.",
        "enum": [
          "artist"
        ]
      },
      "after": {
        "type": "string",
        "description": "The last artist ID retrieved from the previous request."
      },
      "limit": {
        "type": "integer",
        "description": "The maximum number of items to return. Default: 20\\. Minimum: 1\\. Maximum: 50\\."
      }
    },
    "required": [
      "PCID",
      "type"
    ]
  }
  ```
</Expandable>

***

## spotify\_library\_get\_users\_saved\_albums

Get User's Saved Albums

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| --------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer | No       | —       | The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `offset`  | integer | No       | —       | The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `market`  | string  | No       | —       | An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).   If a country code is specified, only content that is available in that market will be returned.\<br/>   If a valid user access token is specified in the request header, the country associated with   the user account will take priority over this parameter.\<br/>   ***Note**: If neither market or user country are provided, the content is considered unavailable for the client.*\<br/>   Users can view the country that is associated with their account in the [account settings](https://www.spotify.com/account/overview/). |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "limit": {
        "type": "integer",
        "description": "The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50."
      },
      "offset": {
        "type": "integer",
        "description": "The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items."
      },
      "market": {
        "type": "string",
        "description": "An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).   If a country code is specified, only content that is available in that market will be returned.<br/>   If a valid user access token is specified in the request header, the country associated with   the user account will take priority over this parameter.<br/>   _**Note**: If neither market or user country are provided, the content is considered unavailable for the client._<br/>   Users can view the country that is associated with their account in the [account settings](https://www.spotify.com/account/overview/)."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## spotify\_library\_get\_users\_saved\_audiobooks

Get User's Saved Audiobooks

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                                                      |
| --------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer | No       | —       | The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.                                     |
| `offset`  | integer | No       | —       | The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "limit": {
        "type": "integer",
        "description": "The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50."
      },
      "offset": {
        "type": "integer",
        "description": "The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## spotify\_library\_get\_users\_saved\_episodes

Get User's Saved Episodes

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| --------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `market`  | string  | No       | —       | An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).   If a country code is specified, only content that is available in that market will be returned.\<br/>   If a valid user access token is specified in the request header, the country associated with   the user account will take priority over this parameter.\<br/>   ***Note**: If neither market or user country are provided, the content is considered unavailable for the client.*\<br/>   Users can view the country that is associated with their account in the [account settings](https://www.spotify.com/account/overview/). |
| `limit`   | integer | No       | —       | The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `offset`  | integer | No       | —       | The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "market": {
        "type": "string",
        "description": "An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).   If a country code is specified, only content that is available in that market will be returned.<br/>   If a valid user access token is specified in the request header, the country associated with   the user account will take priority over this parameter.<br/>   _**Note**: If neither market or user country are provided, the content is considered unavailable for the client._<br/>   Users can view the country that is associated with their account in the [account settings](https://www.spotify.com/account/overview/)."
      },
      "limit": {
        "type": "integer",
        "description": "The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50."
      },
      "offset": {
        "type": "integer",
        "description": "The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## spotify\_library\_get\_users\_saved\_shows

Get User's Saved Shows

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                                                      |
| --------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer | No       | —       | The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.                                     |
| `offset`  | integer | No       | —       | The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "limit": {
        "type": "integer",
        "description": "The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50."
      },
      "offset": {
        "type": "integer",
        "description": "The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## spotify\_library\_get\_users\_saved\_tracks

Get User's Saved Tracks

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| --------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `market`  | string  | No       | —       | An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).   If a country code is specified, only content that is available in that market will be returned.\<br/>   If a valid user access token is specified in the request header, the country associated with   the user account will take priority over this parameter.\<br/>   ***Note**: If neither market or user country are provided, the content is considered unavailable for the client.*\<br/>   Users can view the country that is associated with their account in the [account settings](https://www.spotify.com/account/overview/). |
| `limit`   | integer | No       | —       | The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `offset`  | integer | No       | —       | The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "market": {
        "type": "string",
        "description": "An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).   If a country code is specified, only content that is available in that market will be returned.<br/>   If a valid user access token is specified in the request header, the country associated with   the user account will take priority over this parameter.<br/>   _**Note**: If neither market or user country are provided, the content is considered unavailable for the client._<br/>   Users can view the country that is associated with their account in the [account settings](https://www.spotify.com/account/overview/)."
      },
      "limit": {
        "type": "integer",
        "description": "The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50."
      },
      "offset": {
        "type": "integer",
        "description": "The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## spotify\_library\_get\_users\_top\_artists\_and\_tracks

Get User's Top Items

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                                                                                                                                                                                                                                                       |
| ------------ | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type`       | string  | Yes      | —       | The type of entity to return. Valid values: `artists` or `tracks`                                                                                                                                                                                                                 |
| `time_range` | string  | No       | —       | Over what time frame the affinities are computed. Valid values: `long_term` (calculated from \~1 year of data and including all new data as it becomes available), `medium_term` (approximately last 6 months), `short_term` (approximately last 4 weeks). Default: `medium_term` |
| `limit`      | integer | No       | —       | The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.                                                                                                                                                                                                      |
| `offset`     | integer | No       | —       | The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.                                                                                                                                                                  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "type": {
        "type": "string",
        "description": "The type of entity to return. Valid values: `artists` or `tracks`",
        "enum": [
          "artists",
          "tracks"
        ]
      },
      "time_range": {
        "type": "string",
        "description": "Over what time frame the affinities are computed. Valid values: `long_term` (calculated from ~1 year of data and including all new data as it becomes available), `medium_term` (approximately last 6 months), `short_term` (approximately last 4 weeks). Default: `medium_term`"
      },
      "limit": {
        "type": "integer",
        "description": "The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50."
      },
      "offset": {
        "type": "integer",
        "description": "The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items."
      }
    },
    "required": [
      "PCID",
      "type"
    ]
  }
  ```
</Expandable>

***

## spotify\_library\_remove\_library\_items

Remove Items from Library

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                                                                                                                                                                                                                                                                   |
| --------- | ------ | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uris`    | string | Yes      | —       | A comma-separated list of Spotify URIs. Maximum: 40 URIs.  Supported URI types: - `spotify:track:&#123;id&#125;` - `spotify:album:&#123;id&#125;` - `spotify:episode:&#123;id&#125;` - `spotify:show:&#123;id&#125;` - `spotify:audiobook:&#123;id&#125;` - `spotify:user:&#123;id&#125;` - `spotify:playlist:&#123;id&#125;` |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "uris": {
        "type": "string",
        "description": "A comma-separated list of [Spotify URIs](/documentation/web-api/concepts/spotify-uris-ids). Maximum: 40 URIs.  Supported URI types: - `spotify:track:{id}` - `spotify:album:{id}` - `spotify:episode:{id}` - `spotify:show:{id}` - `spotify:audiobook:{id}` - `spotify:user:{id}` - `spotify:playlist:{id}`"
      }
    },
    "required": [
      "PCID",
      "uris"
    ]
  }
  ```
</Expandable>

***

## spotify\_library\_save\_library\_items

Save Items to Library

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                                                                                                                                                                                                                                                                   |
| --------- | ------ | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uris`    | string | Yes      | —       | A comma-separated list of Spotify URIs. Maximum: 40 URIs.  Supported URI types: - `spotify:track:&#123;id&#125;` - `spotify:album:&#123;id&#125;` - `spotify:episode:&#123;id&#125;` - `spotify:show:&#123;id&#125;` - `spotify:audiobook:&#123;id&#125;` - `spotify:user:&#123;id&#125;` - `spotify:playlist:&#123;id&#125;` |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "uris": {
        "type": "string",
        "description": "A comma-separated list of [Spotify URIs](/documentation/web-api/concepts/spotify-uris-ids). Maximum: 40 URIs.  Supported URI types: - `spotify:track:{id}` - `spotify:album:{id}` - `spotify:episode:{id}` - `spotify:show:{id}` - `spotify:audiobook:{id}` - `spotify:user:{id}` - `spotify:playlist:{id}`"
      }
    },
    "required": [
      "PCID",
      "uris"
    ]
  }
  ```
</Expandable>