How to Update Requests


Why Update Requests?

At some point in time, API providers will change the contract of a request. For example, maybe a component in the request or its response needs to be updated. When this happens we need to update the request on Stoobly's side as well. This is done in one of two ways:

  1. Manually editing the request

  2. Replay and overwriting the request

Updating Requests

Before updating a request, it is recommended to create a snapshot

There are three strategies to update a request:


Editing from the UIEditing with Snapshots


Replaying from the UIReplaying from the CLI

Contract-Driven Updating

Updating with Open API

Reverting Changes

In case you update a request with unintended consequences, you can reset it to the last snapshot state. For more information see our documentation on the snapshots feature:



stoobly-agent request reset


$ stoobly-agent request reset --help

Usage: stoobly-agent request reset [OPTIONS] REQUEST_KEY

  Reset a request to its snapshot state

  --force     Toggles whether resources are hard deleted.
  -h, --help  Show this message and exit.

Last updated