> For the complete documentation index, see [llms.txt](https://docs.stoobly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stoobly.com/getting-started/configuring-an-ai-assistant/skills/stoobly-update-request.md). # Update Request ````markdown --- name: stoobly-update-request description: Updates a recorded request and/or its response via the Stoobly CLI, then persists the change with a request snapshot. Use when a mock response is wrong or outdated, a recorded request body/URL/method/headers need changing, or the user asks to update a request or response without editing snapshot files by hand. --- # Update Request You are helping the user update a recorded request and/or its response. ## Instructions Follow these steps when a stored request or response needs to change. Do not edit snapshot files directly. Scaffold E2E tests version snapshots under `.stoobly/snapshots/`. ### 1. Resolve the context directory Run all `request` and `scenario` commands from the context directory (the directory that contains `.stoobly`). If you do not already know the path, run: ```bash stoobly-agent scaffold describe ``` Use `context_dir_path` from the JSON output: ```bash cd ``` ### 2. Identify the request key You need `` before updating. If the caller already provided it, skip to Step 3. **From a scenario:** ```bash stoobly-agent scenario list --search "" stoobly-agent request list --scenario-key ``` **From a URL or path search:** ```bash stoobly-agent request list --search "/api/users" ``` Note the `key` for the request to update. ### 3. Inspect the current request and response ```bash stoobly-agent request response show ``` Compare the stored request/response with the expected values (body, status, headers, method, path, and so on). ### 4. Update the local database Apply only the fields that need to change. **Response** — body, status, headers, or latency: ```bash stoobly-agent request response update --body '{"id":1}' stoobly-agent request response update --status 201 stoobly-agent request response update --header Content-Type:application/json stoobly-agent request response update --header X-Deprecated: stoobly-agent request response update --latency 500 ``` **Request** — body, URL parts, method, or headers: ```bash stoobly-agent request update --body '{"name":"Alice"}' stoobly-agent request update --method POST --path /api/users stoobly-agent request update --header Authorization:Bearer token ``` Use `--header NAME:` with an empty value to delete a header. ### 5. Verify the update ```bash stoobly-agent request response show ``` Confirm the stored data matches expectations. If this change is for a failing E2E test, re-run that test to confirm the mock behaves correctly before persisting anything to version control. ### 6. Persist to version-controlled snapshots ```bash stoobly-agent request snapshot create --decode ``` Commit the updated snapshot file(s) under `.stoobly/snapshots/` so the change is available locally and in CI. ## Reference documentation | Topic | Doc | | ----- | --- | | Request commands | [Request](../../../faq/request.md) | | Snapshots | [Snapshot](../../../faq/snapshot.md) | | Updating requests | [How to Update Requests](../../../guides/how-to-update-requests/README.md) | | Troubleshoot E2E test | [Troubleshoot E2E Test](stoobly-troubleshoot-e2e-test.md) | ````