salesforce_rest_api
Execute direct REST API calls to Salesforce endpoints for reports, composite, files, approvals, and custom APIs, expanding beyond dedicated tool coverage.
Instructions
Make direct REST API calls to any Salesforce REST endpoint. This is a powerful passthrough tool that gives access to the full Salesforce REST API surface — including endpoints not covered by other tools.
Use this for any Salesforce REST API that doesn't have a dedicated tool, such as:
Reports and Dashboards API: GET /analytics/reports/{reportId}
Composite API: POST /composite
Files and ContentDocument: GET /sobjects/ContentDocument/{id}/VersionData
Approval Processes: POST /process/approvals
Limits and Usage: GET /limits
Tabs and Themes: GET /tabs, GET /theme
Quick Actions: GET /sobjects/{object}/quickActions
Any custom REST endpoint
The endpoint path is relative to /services/data/vXX.0/ (the API version prefix is added automatically).
Examples:
Get org limits:
method: "GET"
endpoint: "/limits"
Run a report:
method: "GET"
endpoint: "/analytics/reports/00O5e000004XXXXEAA"
Composite request (multiple operations in one call):
method: "POST"
endpoint: "/composite"
body: { "allOrNone": true, "compositeRequest": [...] }
Get file content:
method: "GET"
endpoint: "/sobjects/ContentVersion/068XXXXXXXXXXXXXXX/VersionData"
Call a custom REST endpoint:
method: "GET"
endpoint: "/my-custom-endpoint"
rawPath: true
Use a specific API version:
method: "GET"
endpoint: "/limits"
apiVersion: "59.0"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| method | Yes | HTTP method: GET, POST, PATCH, PUT, or DELETE | |
| endpoint | Yes | REST API endpoint path relative to /services/data/vXX.0/ (e.g., '/limits', '/analytics/reports/{id}'). If rawPath is true, this is the full path from root (e.g., '/services/apexrest/my-endpoint'). | |
| body | No | Request body for POST, PATCH, and PUT requests. Will be serialized as JSON. | |
| queryParameters | No | URL query parameters as key-value pairs (e.g., { "includeDetails": "true" }) | |
| apiVersion | No | Override the Salesforce API version (e.g., '59.0', '60.0'). Defaults to the connection's API version. | |
| rawPath | No | If true, the endpoint is treated as a full absolute path from the instance root (e.g., '/services/apexrest/MyEndpoint') instead of being prefixed with /services/data/vXX.0/. Default: false. |