> For the complete documentation index, see [llms.txt](https://docs.podigee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.podigee.com/documentation/start-here/ai-agents/manage-podcasts/update-podcast-settings.md).

# Update podcast settings

Change supported podcast metadata through a reviewed preview and verify the result.

Read the current podcast, then send only the settings you intend to change.

## Before you start

* Keep the target podcast ID.
* Confirm that the connected user can edit this podcast.
* Read the current settings.
* Prepare one stable idempotency key for this update.

## Update the podcast

1. Ask your agent to preview `update_podcast` with the podcast ID, changed attributes, and `dry_run: true`.
2. Review the normalized attributes in the preview.
3. Confirm that omitted settings will not be changed.
4. Correct validation errors and request a new preview when needed.
5. Confirm the exact preview with `dry_run: false` and the same idempotency key.
6. Submit the update once.
7. Read the podcast again and compare the changed fields with the preview.

Supported settings include public metadata, language, categories, owner information, artwork and website URLs, feed item count, publication settings, encoding quality, and transcription settings.

## Expected result

Only the supplied supported settings change on the intended podcast.

## If the update is forbidden

The podcast can be visible without being editable. Ask an organization administrator to grant edit permission, then request a fresh preview under the new authorization.

## If validation fails

Use the returned field error to correct the request. Do not remove unrelated existing settings or replace a value with a guess.

## Next step

[Inspect podcast settings](/documentation/start-here/ai-agents/manage-podcasts/inspect-podcast-settings.md) to verify the saved state.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.podigee.com/documentation/start-here/ai-agents/manage-podcasts/update-podcast-settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.