---
search:
  tags:
    - Podcasts
    - PATCH
seo:
  description: >-
    Update a podcast. Reference for the PATCH /v1/podcasts/{podcast_id} endpoint
    in the Jellypod API.
sidebar:
  label: Update a podcast
  badge: PATCH
title: Update a podcast
type: openapi-operation
---
`PATCH /v1/podcasts/{podcast_id}`

**Request body** (`application/json`, required)

- `author` (string | null) — Credited author for itunes:author and itunes:owner. Null or blank credits the podcast title.
- `description` (string) — Plain text or HTML. Plain text is returned inside \<p\> tags.
- `episode_order` (string)
- `host_ids` (string[])
- `language` (string)
- `primary_category` (string) — Apple Podcasts category or subcategory. The RSS feed nests a subcategory under its parent category.
- `secondary_category` (string | null) — Optional second Apple Podcasts category or subcategory.
- `title` (string)
- `visibility` (string)

Request body example:

```json
{
  "author": "string",
  "description": "string",
  "episode_order": "episodic",
  "host_ids": [
    "string"
  ],
  "language": "string",
  "primary_category": "Arts",
  "secondary_category": "Arts",
  "title": "string",
  "visibility": "public"
}
```

**Responses**

- `200` — Podcast updated
- `400` — Validation failed or malformed request.
- `401` — Missing or invalid API key.
- `403` — Authenticated, but this API key does not have access to this resource.
- `404` — Resource not found.
- `415` — Request \`Content-Type\` is not supported for this endpoint.
- `429` — Rate limit exceeded. Wait \`Retry-After\` seconds before retrying; \`RateLimit-Limit\`, \`RateLimit-Remaining\`, and \`RateLimit-Reset\` describe the window.
- `500` — Internal server error.

Response example, 200:

```json
{
  "data": {
    "author": "string",
    "created_at": "string",
    "description": "string",
    "episode_count": 0,
    "episode_order": "episodic",
    "host_ids": [
      "string"
    ],
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "image_url": "string",
    "languages": [
      "string"
    ],
    "primary_category": "string",
    "rss_feed_url": "string",
    "secondary_category": "string",
    "title": "string",
    "updated_at": "string",
    "url": "string",
    "visibility": "public"
  }
}
```