salesforce-api
Installation
SKILL.md
In Salesforce, every org has its own instance URL (its My Domain), and the API is versioned in the path:
https://<your-org>.my.salesforce.com/services/data/vXX.0/...
Key facts that bite:
- Errors return as a JSON array, success as an object. Guard every jq projection with
if type == "array" then . else <projection> endor the error body crashes the filter and you never seeerrorCode. - Custom objects and fields end in
__c; custom relationship names end in__r(use__rin SOQL parent paths and child subqueries). - Record IDs are 15- or 18-char alphanumeric. The 18-char form is case-insensitive — prefer it.
- SOQL has no
SELECT *.FIELDS(ALL)/FIELDS(CUSTOM)exist but requireLIMIT 200. - Describe is your schema — field names, picklist values, relationship names, and
createable/updateableflags. Read it before guessing field names.