restful
Directly call Salesforce REST APIs to retrieve, create, update, or delete data using specified HTTP methods and endpoint paths.
Instructions
Makes a direct REST API call to Salesforce
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Data for POST/PATCH requests | |
| method | No | The HTTP method (default: 'GET') | GET |
| params | No | Query parameters for the request | |
| path | Yes | The path of the REST API endpoint (e.g., 'sobjects/Account/describe') |
Implementation Reference
- src/salesforce/server.py:448-465 (handler)Handler logic for the 'restful' tool: extracts path, method, params, data from arguments, validates, calls sf_client.sf.restful(), and returns the JSON-formatted result.elif name == "restful": path = arguments.get("path") method = arguments.get("method", "GET") params = arguments.get("params") data = arguments.get("data") if not path: raise ValueError("Missing 'path' argument") if not sf_client.sf: raise ValueError("Salesforce connection not established.") results = sf_client.sf.restful(path, method=method, params=params, json=data) return [ types.TextContent( type="text", text=f"RESTful API Call Result (JSON):\n{json.dumps(results, indent=2)}", ) ]
- src/salesforce/server.py:279-310 (registration)Registration of the 'restful' tool in list_tools(), including description and inputSchema defining path (required), method (default GET), optional params and data.types.Tool( name="restful", description="Makes a direct REST API call to Salesforce", inputSchema={ "type": "object", "properties": { "path": { "type": "string", "description": "The path of the REST API endpoint (e.g., 'sobjects/Account/describe')", }, "method": { "type": "string", "description": "The HTTP method (default: 'GET')", "enum": ["GET", "POST", "PATCH", "DELETE"], "default": "GET", }, "params": { "type": "object", "description": "Query parameters for the request", "properties": {}, "additionalProperties": True, }, "data": { "type": "object", "description": "Data for POST/PATCH requests", "properties": {}, "additionalProperties": True, }, }, "required": ["path"], }, ),