# Add Podcast to Project

> Pod Engine API endpoint reference, optimized for LLM consumption.
> Auto-generated from the source-of-truth endpoint registry.
>
> Category: Projects
> Source: https://www.podengine.ai/api-docs/add-podcast-to-project.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/add-podcast-to-project
> 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`

---

#### POST /api/v1/projects/:projectSlug/podcasts
**Add Podcast to Project**

Add a single podcast to a project's list

```bash
curl -X POST "http://localhost:4000/api/v1/projects/example-project/podcasts" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Path parameters schema:**
```json
{
  "type": "object",
  "properties": {
    "projectSlug": {
      "type": "string"
    }
  },
  "required": [
    "projectSlug"
  ],
  "additionalProperties": false
}
```

**Request body schema:**
```json
{
  "type": "object",
  "properties": {
    "podcastId": {
      "type": "string"
    },
    "state": {
      "default": "prospect",
      "type": "string",
      "enum": [
        "prospect",
        "qualified",
        "pitched",
        "lost",
        "booked",
        "ignored"
      ]
    },
    "priority": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "urgent"
      ]
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "automated",
          "guest-appearance",
          "mcp"
        ]
      }
    }
  },
  "required": [
    "podcastId",
    "state"
  ],
  "additionalProperties": false
}
```

**Response schema:**
```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "listedPodcast": {
          "type": "object",
          "properties": {
            "listedPodcastId": {
              "type": "string"
            },
            "projectId": {
              "type": "string"
            },
            "podcast": {
              "type": "object",
              "properties": {
                "podcastId": {
                  "type": "string"
                },
                "titleOriginal": {
                  "type": "string"
                },
                "titleLatest": {
                  "type": "string"
                },
                "slug": {
                  "type": "string"
                },
                "imageUrl": {
                  "nullable": true,
                  "type": "string"
                }
              },
              "required": [
                "podcastId",
                "titleOriginal",
                "titleLatest",
                "slug",
                "imageUrl"
              ],
              "additionalProperties": false
            },
            "status": {
              "type": "string",
              "enum": [
                "prospect",
                "qualified",
                "pitched",
                "lost",
                "booked",
                "ignored"
              ]
            },
            "priority": {
              "nullable": true,
              "type": "string",
              "enum": [
                "low",
                "medium",
                "high",
                "urgent"
              ]
            },
            "labels": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "addedAt": {},
            "updatedAt": {},
            "addedByUser": {
              "type": "object",
              "properties": {
                "userId": {
                  "type": "string"
                },
                "email": {
                  "type": "string"
                },
                "displayName": {
                  "nullable": true,
                  "type": "string"
                }
              },
              "required": [
                "userId",
                "email",
                "displayName"
              ],
              "additionalProperties": false
            },
            "activityHistory": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "actionType": {
                    "type": "string",
                    "enum": [
                      "added-to-list",
                      "update-labels",
                      "update-priority",
                      "update-state"
                    ]
                  },
                  "activityDate": {},
                  "fromValue": {
                    "nullable": true,
                    "type": "string"
                  },
                  "toValue": {
                    "nullable": true,
                    "type": "string"
                  },
                  "userId": {
                    "type": "string"
                  },
                  "userDisplayName": {
                    "type": "string"
                  }
                },
                "required": [
                  "actionType",
                  "activityDate",
                  "fromValue",
                  "toValue",
                  "userId",
                  "userDisplayName"
                ],
                "additionalProperties": false
              }
            },
            "analysis": {
              "type": "object",
              "properties": {
                "relevancyScore": {
                  "nullable": true,
                  "type": "number"
                },
                "deepRelevancyScore": {
                  "nullable": true,
                  "type": "number"
                },
                "hostRelevancyScore": {
                  "nullable": true,
                  "type": "number"
                }
              },
              "additionalProperties": false
            }
          },
          "required": [
            "listedPodcastId",
            "projectId",
            "podcast",
            "status",
            "priority",
            "labels",
            "addedAt",
            "updatedAt",
            "addedByUser",
            "activityHistory",
            "analysis"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "listedPodcast"
      ],
      "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