# app.rocksky.playlist.defs

> Published by [rocksky.app](https://lexicon.garden/identity/did:plc:vegqomyce4ssoqs7zwqvgqty)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.playlist.defs)
- [Documentation](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.playlist.defs/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.playlist.defs/examples)

## Definitions

### `app.rocksky.playlist.defs#playlistViewBasic`

**Type**: `object`

Basic view of a playlist, including its metadata

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `coverImageUrl` | `string` (uri) | No | The URL of the cover image for the playlist. |
| `createdAt` | `string` (datetime) | No | The date and time when the playlist was created. |
| `curatorAvatarUrl` | `string` (uri) | No | The URL of the avatar image of the curator. |
| `curatorDid` | `string` (at-identifier) | No | The DID of the curator of the playlist. |
| `curatorHandle` | `string` (at-identifier) | No | The handle of the curator of the playlist. |
| `curatorName` | `string` | No | The name of the curator of the playlist. |
| `description` | `string` | No | A description of the playlist. |
| `id` | `string` | No | The unique identifier of the playlist. |
| `title` | `string` | No | The title of the playlist. |
| `trackArts` | `array` | No | Album-art URLs of up to four of the playlist's tracks, for rendering a cover mosaic when the playlist has no picture of its own. |
| `trackCount` | `integer` | No | The number of tracks in the playlist. |
| `uri` | `string` (at-uri) | No | The URI of the playlist. |

### `app.rocksky.playlist.defs#playlistViewDetailed`

**Type**: `object`

Detailed view of a playlist, including its tracks and metadata

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `coverImageUrl` | `string` (uri) | No | The URL of the cover image for the playlist. |
| `createdAt` | `string` (datetime) | No | The date and time when the playlist was created. |
| `curatorAvatarUrl` | `string` (uri) | No | The URL of the avatar image of the curator. |
| `curatorDid` | `string` (at-identifier) | No | The DID of the curator of the playlist. |
| `curatorHandle` | `string` (at-identifier) | No | The handle of the curator of the playlist. |
| `curatorName` | `string` | No | The name of the curator of the playlist. |
| `description` | `string` | No | A description of the playlist. |
| `id` | `string` | No | The unique identifier of the playlist. |
| `title` | `string` | No | The title of the playlist. |
| `tracks` | `array` | No | A list of tracks in the playlist. |
| `uri` | `string` (at-uri) | No | The URI of the playlist. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "playlistViewBasic": {
      "description": "Basic view of a playlist, including its metadata",
      "properties": {
        "coverImageUrl": {
          "description": "The URL of the cover image for the playlist.",
          "format": "uri",
          "type": "string"
        },
        "createdAt": {
          "description": "The date and time when the playlist was created.",
          "format": "datetime",
          "type": "string"
        },
        "curatorAvatarUrl": {
          "description": "The URL of the avatar image of the curator.",
          "format": "uri",
          "type": "string"
        },
        "curatorDid": {
          "description": "The DID of the curator of the playlist.",
          "format": "at-identifier",
          "type": "string"
        },
        "curatorHandle": {
          "description": "The handle of the curator of the playlist.",
          "format": "at-identifier",
          "type": "string"
        },
        "curatorName": {
          "description": "The name of the curator of the playlist.",
          "type": "string"
        },
        "description": {
          "description": "A description of the playlist.",
          "type": "string"
        },
        "id": {
          "description": "The unique identifier of the playlist.",
          "type": "string"
        },
        "title": {
          "description": "The title of the playlist.",
          "type": "string"
        },
        "trackArts": {
          "description": "Album-art URLs of up to four of the playlist's tracks, for rendering a cover mosaic when the playlist has no picture of its own.",
          "items": {
            "format": "uri",
            "type": "string"
          },
          "type": "array"
        },
        "trackCount": {
          "description": "The number of tracks in the playlist.",
          "minimum": 0,
          "type": "integer"
        },
        "uri": {
          "description": "The URI of the playlist.",
          "format": "at-uri",
          "type": "string"
        }
      },
      "type": "object"
    },
    "playlistViewDetailed": {
      "description": "Detailed view of a playlist, including its tracks and metadata",
      "properties": {
        "coverImageUrl": {
          "description": "The URL of the cover image for the playlist.",
          "format": "uri",
          "type": "string"
        },
        "createdAt": {
          "description": "The date and time when the playlist was created.",
          "format": "datetime",
          "type": "string"
        },
        "curatorAvatarUrl": {
          "description": "The URL of the avatar image of the curator.",
          "format": "uri",
          "type": "string"
        },
        "curatorDid": {
          "description": "The DID of the curator of the playlist.",
          "format": "at-identifier",
          "type": "string"
        },
        "curatorHandle": {
          "description": "The handle of the curator of the playlist.",
          "format": "at-identifier",
          "type": "string"
        },
        "curatorName": {
          "description": "The name of the curator of the playlist.",
          "type": "string"
        },
        "description": {
          "description": "A description of the playlist.",
          "type": "string"
        },
        "id": {
          "description": "The unique identifier of the playlist.",
          "type": "string"
        },
        "title": {
          "description": "The title of the playlist.",
          "type": "string"
        },
        "tracks": {
          "description": "A list of tracks in the playlist.",
          "items": {
            "ref": "app.rocksky.song.defs#songViewBasic",
            "type": "ref"
          },
          "type": "array"
        },
        "uri": {
          "description": "The URI of the playlist.",
          "format": "at-uri",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "id": "app.rocksky.playlist.defs",
  "lexicon": 1
}
```