> 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/make-changes-safely.md).

# Make changes safely

- [Understand read-only and write operations](https://docs.podigee.com/documentation/start-here/ai-agents/make-changes-safely/understand-read-only-and-write-operations.md): Distinguish Podigee operations that inspect data from operations that can change an account.
- [Preview a change before it runs](https://docs.podigee.com/documentation/start-here/ai-agents/make-changes-safely/preview-a-change-before-it-runs.md): Request and review a side-effect-free Podigee preview before a consequential change.
- [Confirm a consequential change](https://docs.podigee.com/documentation/start-here/ai-agents/make-changes-safely/confirm-a-consequential-change.md): Apply the exact Podigee change shown in a valid preview and reject changed or stale requests.
- [Prevent duplicate changes with idempotency keys](https://docs.podigee.com/documentation/start-here/ai-agents/make-changes-safely/prevent-duplicate-changes-with-idempotency-keys.md): Use one stable idempotency key to retry a Podigee change without creating duplicate work.
- [Understand durable operations](https://docs.podigee.com/documentation/start-here/ai-agents/make-changes-safely/understand-durable-operations.md): Understand the states and recovery model for long-running Podigee agent operations.
- [Monitor a long-running operation](https://docs.podigee.com/documentation/start-here/ai-agents/make-changes-safely/monitor-a-long-running-operation.md): Follow one durable Podigee operation from acceptance to a verified terminal result.
- [Resume or cancel an operation](https://docs.podigee.com/documentation/start-here/ai-agents/make-changes-safely/resume-or-cancel-an-operation.md): Resume recoverable Podigee work or cancel eligible active work with a fresh safety check.
- [Recover after a disconnect or reauthorization](https://docs.podigee.com/documentation/start-here/ai-agents/make-changes-safely/recover-after-a-disconnect-or-reauthorization.md): Reconnect to Podigee and recover existing work without repeating the original action.
- [Verify that a change had the intended effect](https://docs.podigee.com/documentation/start-here/ai-agents/make-changes-safely/verify-that-a-change-had-the-intended-effect.md): Read Podigee state after a change and distinguish an accepted request from its real effect.
- [Choose a reversible action before permanent deletion](https://docs.podigee.com/documentation/start-here/ai-agents/make-changes-safely/choose-a-reversible-action-before-permanent-deletion.md): Prefer a reversible Podigee state when you do not need to remove data permanently.


---

# 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/make-changes-safely.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.