> 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/find-an-accessible-podcast.md).

# Find an accessible podcast

List podcasts available to the connected Podigee account and keep the correct ID.

List the podcasts inside the current account boundary before you request podcast-specific work.

## Before you start

* Check the connected Podigee identity and tenant.
* Know the podcast title or other details you expect to find.

## Find the podcast

1. Ask your agent to list accessible podcasts.
2. Review each podcast ID, title, subdomain, language, publication type, and published date.
3. Match the intended podcast by more than its title when similar names exist.
4. Keep the selected podcast ID for later calls.
5. If `pagination.next_offset` is present, request the next page with that offset.
6. Continue until you find the podcast or reach the final page.

The default page contains 25 podcasts. You can request up to 100 at once.

## Expected result

You have one podcast ID that belongs to the connected Podigee account and matches the intended workspace.

## If the list is empty

Confirm the connected user and account. The user might not have access to any podcast in that tenant. An administrator can grant access, or an account-level user can create a podcast when the plan allows it.

## If the podcast is missing

Continue through all pages. If it is still absent, do not guess its ID. Reconnect to the correct account or request access.

## Next step

[Inspect podcast settings](/documentation/start-here/ai-agents/manage-podcasts/inspect-podcast-settings.md).


---

# 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/find-an-accessible-podcast.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.
