---
title: "edit_heading"
description: "Edit the heading"
canonical: "https://poddub.com/docs/agents/tools/edit_heading"
last-updated: "2026-10-29"
---

# edit_heading

Edit the heading

Renames the episode's title or its summary on the latest version; a call sends at least one of the two. While the script is in review any member who can see the episode can use it, and after approval only owners and admins can. It never touches the turns.

## What the server says

The description an agent is given, word for word. This tool makes changes.

> Rename the episode's title or summary on the latest version. Send at least one of the two: a call with neither is refused. In review any member may; after approval, owners and admins only.

## Input

| Field       | Type         | Required | What it takes                                                               |
| ----------- | ------------ | -------- | --------------------------------------------------------------------------- |
| `version`   | whole number | yes      | 1 or more                                                                   |
| `title`     | text         | no       | 1 to 120 characters                                                         |
| `summary`   | text         | no       | 1 to 600 characters                                                         |
| `episodeId` | text         | yes      | not empty; The episode's id, as list_episodes or create_episode answers it. |

## Refusals

A refusal comes back as the tool's result, marked as an error, with the code and what explains it.

| Code                      | What it means                                                                                                                                                                          |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `episode_not_found`       | No such episode among the ones the person can see.                                                                                                                                     |
| `script_not_found`        | The episode has no script yet: poddub is still writing it.                                                                                                                             |
| `episode_state_conflict`  | The episode is not in a state that allows this: a script no longer in review, or a retry of an episode that has not failed. The refusal says the state it is in.                       |
| `script_version_conflict` | The version named is not the latest, because the script changed since it was read. The refusal carries the latest version: read the script again.                                      |
| `heading_edit_forbidden`  | After approval only owners and admins can rename an episode.                                                                                                                           |
| `invalid_body`            | What was sent breaks a rule the input table cannot show: a new text that would break the script, or a fallback for a step that is not the audio, or an engine the show does not offer. |

Every tool can also answer `rate_limited` and `not_a_member`: see [Limits](/docs/agents/limits) and [Keys](/docs/agents/keys).