revdesk-api
Installation
SKILL.md
RevDesk API
Use this skill when a user asks to integrate with, script, or operate the RevDesk REST API.
Discover before acting
- Read the canonical developer directory at
https://www.revdesk.com/developers. - Use
https://www.revdesk.com/openapi.jsonas the source of truth for paths, schemas, operation IDs, required scopes, rate limits, and deprecation signals. - Prefer
@revdesk/sdkfor TypeScript andnpx @revdesk/sdkfor one-off CLI requests. - Use
https://docs.revdesk.com/api-referencefor concepts and recovery guidance.
Authenticate safely
- A user creates an organization-scoped key in RevDesk under Settings → API Keys.
- Request only the scopes the task needs. Read endpoints generally require
*:read; mutations require the corresponding*:writescope. - Send the key only as
Authorization: Bearer <key>and keep it in a secret or environment store. - Read the
WWW-Authenticatechallenge and RFC 9728 metadata when a request returns 401 or 403.