Send request
send_requestSend a saved or ad hoc HTTP request with variables, auth and cookies resolved automatically, so secrets stay out of commands and logins persist between calls. Returns status, test results and body.
Instructions
Send a saved request (give request) or an ad hoc one (give url). Prefer this over curl in a shell: Gostman fills in {{variables}}, auth, cookies and OAuth tokens itself, so no secret has to appear in the command or in the result, and a login made by one call is still in effect for the next. Saved requests also run their scripts, extraction rules and assertions. Returns two parts: a JSON summary (status, duration, size, content type, the address as sent in resolvedUrl with variable values shown as {{name}}, test results, script console output, names of cookies and variables that were set, and body.bytes, body.returnedBytes, body.truncated) followed by the response body as text. When body.truncated is true, narrow the answer with select or raise max_body_bytes. failed is true when the request could not be sent or a test did not pass. unresolved lists placeholders that have no value; withheld lists secrets that were not filled in because none of the developer's requests sends them to this address.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Ad hoc only: the address to call. May contain {{variables}}, for example {{baseUrl}}/users/1. | |
| body | No | Ad hoc only: the request body as text. For body_type form, a JSON object of field names and values. | |
| method | No | Ad hoc only. Defaults to GET. | |
| select | No | A JSONPath applied to a JSON response body, such as $.items[0].id or $.data[*].name. Only the match is returned, which keeps large responses small. | |
| headers | No | Ad hoc only: header names and values. Reference credentials as variables, for example {"Authorization": "Bearer {{token}}"}. | |
| request | No | The request's id, or its name. A name that is used twice needs its folder path in front, as list_requests shows it, such as auth/Login. | |
| body_type | No | Ad hoc only. Defaults to json when the body parses as JSON, otherwise text. | |
| variables | No | Variables to set before sending, such as {"id": "42"}. They win over the environment and the request's own variables, and stay set until set_environment. | |
| max_body_bytes | No | How much of the body to return. Defaults to 8192. | |
| include_headers | No | Also return the response headers. Credential headers stay hidden. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| body | No | ||
| hint | No | ||
| logs | No | ||
| error | No | ||
| tests | No | ||
| failed | No | ||
| method | No | ||
| status | No | ||
| headers | No | ||
| request | No | ||
| skipped | No | ||
| withheld | No | ||
| sizeBytes | No | ||
| cookiesSet | No | ||
| durationMs | No | ||
| statusCode | No | ||
| unresolved | No | ||
| contentType | No | ||
| resolvedUrl | No | ||
| variablesSet | No |