execute_request
Execute HTTP requests to API endpoints and extract specific data using JSONPath to reduce token usage.
Instructions
Execute HTTP requests to API endpoints. Returns compact response by default (no headers, no server_context). Use include_headers/include_server_context for full details. Full unfiltered response is always cached — use replay_response to re-inspect without re-executing. PREFERRED: If you know or can predict the response structure, always pass a jsonpath param to extract only the needed fields — this saves tokens and avoids re-execution. e.g. jsonpath='$.data.access_token' to get a token, '$.results' for a list. Root $ = response body directly.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | API path, use exactly as listed in the spec (e.g., '/api/v1/users/') | |
| method | Yes | HTTP method | |
| path_params | No | Path parameters | |
| query_params | No | Query parameters | |
| headers | No | Request headers | |
| body | No | Request body — JSON object {} or array [] depending on the endpoint | |
| include_headers | No | Include response headers (default: false) | |
| include_server_context | No | Include server context in response (default: false) | |
| jsonpath | No | JSONPath to filter the response body directly. Root $ = body root. e.g. '$.data.access_token' not '$.body.data.access_token' | |
| max_body_length | No | Max characters for response body. Truncates with ...[truncated] if exceeded. |