# Add Podcast to Team

> Pod Engine API endpoint reference, optimized for LLM consumption.
> Auto-generated from the source-of-truth endpoint registry.
>
> Category: Teams
> Source: https://www.podengine.ai/api-docs/add-podcast-to-team.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/add-podcast-to-team
> Full API reference (all endpoints): https://www.podengine.ai/api-docs/llms.txt

**Base URL:** `http://localhost:4000`
**Auth:** Requires a Bearer token: `Authorization: Bearer YOUR_API_KEY`

---

#### PUT /api/v1/teams/podcasts/:podcastId
**Add Podcast to Team**

Add a podcast to your team

```bash
curl -X PUT "http://localhost:4000/api/v1/teams/podcasts/58bb043a-ad45-4844-a6d8-7492d901dc30" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "sync": false,
  "blacklist": false
}'
```

**Path parameters schema:**
```json
{
  "type": "object",
  "properties": {
    "podcastId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Podengine ID"
    }
  },
  "required": [
    "podcastId"
  ],
  "additionalProperties": false
}
```

**Request body schema:**
```json
{
  "type": "object",
  "properties": {
    "sync": {
      "nullable": true,
      "type": "boolean"
    },
    "blacklist": {
      "nullable": true,
      "type": "boolean"
    }
  },
  "required": [
    "sync",
    "blacklist"
  ],
  "additionalProperties": false
}
```

**Response schema:**
```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "teamPodcast": {
          "type": "object",
          "properties": {
            "addedByUserId": {
              "nullable": true,
              "type": "string"
            },
            "addedReason": {
              "type": "string",
              "enum": [
                "add-to-team-podcasts-button",
                "listed-podcast",
                "migration",
                "script",
                "search-export"
              ]
            },
            "blacklist": {
              "type": "boolean"
            },
            "createdAt": {},
            "podcast": {
              "type": "object",
              "properties": {
                "author": {
                  "nullable": true,
                  "type": "string"
                },
                "authorityScore": {
                  "nullable": true,
                  "type": "object",
                  "properties": {
                    "calculatedAt": {},
                    "authorityScore": {
                      "type": "number",
                      "description": "This is the weighted total authority score of the podcast, out of 100"
                    },
                    "qualityScore": {
                      "type": "number",
                      "description": "This is the quality score of the podcast, out of 100"
                    },
                    "youtubeScore": {
                      "type": "number",
                      "description": "This is the YouTube score of the podcast, out of 100"
                    },
                    "socialScore": {
                      "type": "number",
                      "description": "This is the social score of the podcast, out of 100"
                    },
                    "engagementScore": {
                      "type": "number",
                      "description": "This is the engagement score of the podcast, out of 100"
                    }
                  },
                  "required": [
                    "calculatedAt",
                    "authorityScore",
                    "qualityScore",
                    "youtubeScore",
                    "socialScore",
                    "engagementScore"
                  ],
                  "additionalProperties": false
                },
                "genres": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "id": {
                  "type": "string"
                },
                "imageUrl": {
                  "nullable": true,
                  "type": "string"
                },
                "language": {
                  "type": "string"
                },
                "lastEpisodePublishedAt": {},
                "slug": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "titleLatest": {
                  "type": "string"
                }
              },
              "required": [
                "author",
                "authorityScore",
                "genres",
                "id",
                "imageUrl",
                "language",
                "lastEpisodePublishedAt",
                "slug",
                "title",
                "titleLatest"
              ],
              "additionalProperties": false
            },
            "podcastId": {
              "type": "string"
            },
            "projects": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "projectId": {
                    "type": "string"
                  },
                  "addedByUserId": {
                    "type": "string"
                  },
                  "listedPodcastState": {
                    "type": "string",
                    "enum": [
                      "prospect",
                      "qualified",
                      "pitched",
                      "lost",
                      "booked",
                      "ignored"
                    ]
                  }
                },
                "required": [
                  "projectId",
                  "addedByUserId",
                  "listedPodcastState"
                ],
                "additionalProperties": false
              }
            },
            "sync": {
              "type": "boolean"
            },
            "teamId": {
              "type": "string"
            },
            "lastAirtableSync": {},
            "lastAirtableErrorSyncDate": {},
            "airtableRecordId": {
              "type": "string"
            }
          },
          "required": [
            "addedByUserId",
            "addedReason",
            "blacklist",
            "createdAt",
            "podcast",
            "podcastId",
            "projects",
            "sync",
            "teamId"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "teamPodcast"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "status",
    "data"
  ],
  "additionalProperties": false
}
```

---

## See also

- All endpoints in one file: https://www.podengine.ai/api-docs/llms.txt
- Full reference with every schema inlined: https://www.podengine.ai/api-docs/llms-full.txt
- OpenAPI 3.1 spec: https://www.podengine.ai/api-docs/openapi.json
- Get an API key: https://www.podengine.ai/get-started
- Support: support@podengine.ai