> 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/check-your-account-and-readiness/run-a-podigee-connection-health-check.md).

# Run a Podigee connection health check

Preflight authentication, subscription, podcast access, imports, allowances, and readiness.

Use the Podigee doctor before a bulk workflow or a change that depends on plan capacity.

## Before you start

* Confirm the connected identity and account.
* Obtain a podcast ID when you need encoding and publication checks for one podcast.
* Decide whether the planned workflow needs write access.

## Run the health check

1. Ask your agent to run the Podigee doctor.
2. Provide `podcast_id` when the work targets a specific podcast.
3. Set `check_write` to `true` when the workflow will change Podigee data.
4. Review `auth`, `subscription`, and `write_mode`.
5. Review podcast license usage and any blocked podcast IDs.
6. Review the import check when you plan to import a podcast.
7. Review encoding and publication readiness for the selected podcast.
8. Review every relevant allowance, its usage, remaining amount, status, and reset date.

Also check the connected identity's scopes. A healthy server write mode does not replace the write scope required by a specific tool.

## Expected result

`ok` is `true`, the subscription is active, the selected podcast is not blocked, encoding and publication checks pass, and the required allowance has enough capacity.

## If a check is blocked

Follow the returned message. Select another eligible podcast, wait for a period reset, reduce the planned batch, restore the required permission, or use the current `/upgrade` route when the plan does not include the required capacity.

Do not retry a plan or subscription failure as if it were a temporary network error.

## If an allowance is unavailable

Treat its ceiling as unknown. Do not assume that a missing value means unlimited capacity. Run the check again later or confirm the allowance in Podigee before a bulk operation.

## Next step

* [Understand plan allowances and usage](/documentation/start-here/ai-agents/check-your-account-and-readiness/understand-plan-allowances-and-usage.md)
* [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/check-your-account-and-readiness/run-a-podigee-connection-health-check.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.