save_request
Save a reusable sample HTTP request payload (method, path, headers, body, and scenario description) to the Simceptor Playground. Returns the created saved-request object. Call this after verifying a mock scenario with test_mock so developers and future AI sessions can discover and replay the exact test payload via get_saved_requests or the Playground UI.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"method": "<method>",
"url": "<url>"
},
"name": "save_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Target request URL or path with path variables resolved, e.g. '/api/v1/payments' or 'https://api.simceptor.com/mock/slug/api/v1/payments'. | |
| body | No | Optional request body payload string (JSON, XML, or form-urlencoded). | |
| name | Yes | Descriptive name for this request scenario, e.g. 'Success Case', 'Validation Error', 'Unauthorized Token'. | |
| method | Yes | HTTP method to send (e.g. GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS). | |
| headers | No | Optional HTTP request headers serialized as a JSON string, e.g. '{"Authorization":"Bearer xxx","Content-Type":"application/json"}'. | |
| mockName | No | Optional name of the associated mock API endpoint. | |
| description | No | Optional explanation of what this test request validates and which rule scenario it should trigger. | |
| projectName | No | Optional name of the associated project workspace for grouping in the Playground. | |
| collectionName | No | Optional name of the associated collection folder. | |
| responseStatus | No | Optional expected HTTP response status code for this test case (e.g. 200, 400, 422). |