# org.swappulse.podcastEpisode

> Published by [bridge.swappulse.org](https://lexicon.garden/identity/did:plc:jwoatauidzr4lollmro2gh35)

## Description

A podcast episode (often derived from a voice space recording), mirrored to AT Protocol as a real org.swappulse.podcastEpisode record so episodes are portable and playable across instances.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:jwoatauidzr4lollmro2gh35/org.swappulse.podcastEpisode)
- [Documentation](https://lexicon.garden/lexicon/did:plc:jwoatauidzr4lollmro2gh35/org.swappulse.podcastEpisode/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:jwoatauidzr4lollmro2gh35/org.swappulse.podcastEpisode/examples)

## Definitions

### `org.swappulse.podcastEpisode`

**Type**: `record`

A podcast episode.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `tags` | `array` | No |  |
| `title` | `string` | Yes |  |
| `hostDid` | `string` (did) | No |  |
| `audioUrl` | `string` (uri) | Yes |  |
| `hostName` | `string` | No |  |
| `createdAt` | `string` (datetime) | Yes |  |
| `playCount` | `integer` | No |  |
| `showNotes` | `string` | No |  |
| `hostAvatar` | `string` (uri) | No |  |
| `hostHandle` | `string` | No |  |
| `description` | `string` | No |  |
| `publishedAt` | `string` (datetime) | Yes |  |
| `chapterMarks` | `array` | No |  |
| `seasonNumber` | `integer` | No |  |
| `coverImageUrl` | `string` (uri) | No |  |
| `episodeNumber` | `integer` | No |  |
| `sourceSpaceId` | `string` | No |  |
| `durationSeconds` | `integer` | Yes |  |

## Raw Schema

```json
{
  "id": "org.swappulse.podcastEpisode",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "title",
          "audioUrl",
          "durationSeconds",
          "publishedAt",
          "createdAt"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 30
            },
            "maxLength": 10
          },
          "title": {
            "type": "string",
            "maxLength": 200
          },
          "hostDid": {
            "type": "string",
            "format": "did"
          },
          "audioUrl": {
            "type": "string",
            "format": "uri"
          },
          "hostName": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "playCount": {
            "type": "integer"
          },
          "showNotes": {
            "type": "string",
            "maxLength": 5000
          },
          "hostAvatar": {
            "type": "string",
            "format": "uri"
          },
          "hostHandle": {
            "type": "string"
          },
          "description": {
            "type": "string",
            "maxLength": 2000
          },
          "publishedAt": {
            "type": "string",
            "format": "datetime"
          },
          "chapterMarks": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string",
                  "maxLength": 100
                },
                "cardUri": {
                  "type": "string"
                },
                "timestampSeconds": {
                  "type": "integer"
                }
              }
            }
          },
          "seasonNumber": {
            "type": "integer",
            "minimum": 1
          },
          "coverImageUrl": {
            "type": "string",
            "format": "uri"
          },
          "episodeNumber": {
            "type": "integer",
            "minimum": 1
          },
          "sourceSpaceId": {
            "type": "string"
          },
          "durationSeconds": {
            "type": "integer",
            "minimum": 1
          }
        }
      },
      "description": "A podcast episode."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "revision": 1,
  "description": "A podcast episode (often derived from a voice space recording), mirrored to AT Protocol as a real org.swappulse.podcastEpisode record so episodes are portable and playable across instances."
}
```