> 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/inspect-or-prepare-a-workspace-in-one-guided-flow.md).

# Inspect or prepare a workspace in one guided flow

Use the guided workspace workflow to inspect, create, or update one podcast safely.

Use `manage_workspace` when an agent needs account context and one podcast action in a single guided workflow.

## Before you start

* Confirm the connected Podigee account.
* Decide whether you want to inspect, create, or update a podcast.
* Prepare an idempotency key for a create or update action.

## Inspect a workspace

1. Ask the agent to run `manage_workspace` without change attributes.
2. Provide a `podcast_id` to inspect one podcast.
3. Set `list_episodes` to `true` when you also need the first 10 episodes.
4. Review the connected account, accessible podcast list, selected podcast, and recommended next workflow.

An inspection does not require write access.

## Create or update in the guided flow

1. Supply `create_attributes` for a new podcast, or a `podcast_id` with `update_attributes` for an existing podcast.
2. Set `dry_run` to `true` and review the preview.
3. Confirm the exact preview with the same idempotency key and the `confirm` value from the preview.
4. Submit only one create or update action in the request.
5. Read the returned podcast and optional episode list.

## Expected result

The workflow returns account context, accessible podcasts, the selected or newly prepared podcast, an optional episode page, and the next recommended workflow.

## If the request is rejected

Do not combine create and update attributes or update without a podcast ID. Confirm write access for changes, correct the request, and generate a fresh preview.

## Next step

[Check encoding and publication readiness](/documentation/start-here/ai-agents/check-your-account-and-readiness/check-encoding-and-publication-readiness.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/inspect-or-prepare-a-workspace-in-one-guided-flow.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.