---
title: "list_episodes"
description: "List episodes"
canonical: "https://poddub.com/docs/agents/tools/list_episodes"
last-updated: "2026-10-29"
---

# list_episodes

List episodes

Lists the episodes its person can see, with their state, title and any failure; a team or a state narrows the list. Any member can use it and sees what the app would show them. It never changes an episode.

## What the server says

The description an agent is given, word for word. This tool only reads; it changes nothing.

> The episodes you can see, with their state, title and failure; teamId and state narrow the list.

## Input

| Field    | Type | Required | What it takes                                                                            |
| -------- | ---- | -------- | ---------------------------------------------------------------------------------------- |
| `teamId` | text | no       |                                                                                          |
| `state`  | text | no       | one of `scripting`, `review`, `rendering`, `ready`, `published`, `unpublished`, `failed` |

## Refusals

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

This tool has no refusals of its own.

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