Save request
save_requestCreate or update a request in the workspace so the developer finds it in the Gostman app and can re-run it later; only supplied fields change, and secrets must be {{variable}} references.
Instructions
Create a request in the workspace, or update one by id, so the developer finds it in the Gostman app and it can be re-run later. Only the fields you give are changed. Secrets are refused: a value that matches a variable or a credential must be written as {{name}}. Returns the request's id, name, folder and new revision. An update is refused when the request changed since you read it with get_request; read it again and merge.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "save_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The id of the request to update. Leave out to create a new request. | |
| url | No | Required for a new request. Use {{variables}} for hosts and credentials, for example {{baseUrl}}/users. | |
| body | No | The request body as text. | |
| name | No | Required for a new request. | |
| tags | No | Replaces the request's tags, such as smoke. run_folder runs a tagged subset. | |
| folder | No | The folder path to keep the request in, such as auth/tokens. Missing folders are created. An empty string moves it to the top level. | |
| method | No | GET, POST and so on. Defaults to GET. | |
| headers | No | Replaces the request's headers. Credentials must be variable references. | |
| revision | No | The revision you last read (from get_request, list_environments or a save). The save is refused if the item has changed since. Leave out to use the one this session last saw. | |
| body_type | No | How the body is sent. | |
| assertions | No | Replaces the request's checks. They run every time the request is sent, here and in the app. | |
| extractors | No | Replaces the request's extraction rules. After each response, every rule stores a value in a session variable, so a login can hand its token to later requests as {{token}} without the token appearing in a result. | |
| description | No | What the request does, in a sentence. Shown in the app and used as the tool description with --expose-tag. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| name | No | ||
| note | No | ||
| folder | No | ||
| created | No | ||
| revision | No |