> 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-episodes.md).

# Manage episodes

- [Find and filter episodes](https://docs.podigee.com/documentation/start-here/ai-agents/manage-episodes/find-and-filter-episodes.md): Find episodes by title, publication state, date range, sort order, and page.
- [Inspect an episode](https://docs.podigee.com/documentation/start-here/ai-agents/manage-episodes/inspect-an-episode.md): Read one episode's metadata, media, publication, transcript, and distribution context.
- [Create a draft episode](https://docs.podigee.com/documentation/start-here/ai-agents/manage-episodes/create-a-draft-episode.md): Create and verify an unpublished episode record without uploading or publishing media.
- [Update episode metadata](https://docs.podigee.com/documentation/start-here/ai-agents/manage-episodes/update-episode-metadata.md): Change supported episode metadata through a reviewed preview and verify the saved fields.
- [Schedule or reschedule an episode](https://docs.podigee.com/documentation/start-here/ai-agents/manage-episodes/schedule-or-reschedule-an-episode.md): Set a future publication time for an existing episode through the publishing workflow.
- [Change an episode publication state](https://docs.podigee.com/documentation/start-here/ai-agents/manage-episodes/change-an-episode-publication-state.md): Move an existing episode between draft, scheduled, and published states safely.
- [Replace chapter marks, keywords, or transcript data safely](https://docs.podigee.com/documentation/start-here/ai-agents/manage-episodes/replace-chapter-marks-keywords-or-transcript-data-safely.md): Replace episode collection fields without losing entries that should remain.
- [Update several episodes in one request](https://docs.podigee.com/documentation/start-here/ai-agents/manage-episodes/update-several-episodes-in-one-request.md): Preview and apply independent metadata updates to as many as 50 episodes.
- [Delete an episode permanently](https://docs.podigee.com/documentation/start-here/ai-agents/manage-episodes/delete-an-episode-permanently.md): Permanently delete one episode only after reviewing the irreversible effect.
- [Understand episode fields and states](https://docs.podigee.com/documentation/start-here/ai-agents/manage-episodes/understand-episode-fields-and-states.md): Reference the episode metadata, publication states, media indicators, and collection behavior.


---

# 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-episodes.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.