velt-rest-apis-best-practices
Velt REST API v2 and webhook best practices for server-side integration. Use when calling Velt REST API v2 endpoints, generating JWT tokens for frontend authentication, handling Velt webhooks (comment events, huddle events, CRDT updates), managing users/documents/organizations via REST, or implementing server-side Velt operations. Triggers on any task involving Velt REST API, JWT token generation for Velt, Velt webhooks, x-velt-api-key headers, or server-side comment/notification/activity management — even if the user doesn't explicitly say 'REST API'. For the Python SDK (velt-py) for self-hosting, see velt-self-hosting-data-best-practices instead.
Install
With your agent
Install OMGSkills skill "velt-js/velt-plugin-cursor:skills/velt-rest-apis-best-practices" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/velt-js/velt-plugin-cursor /tmp/velt-plugin-cursor && ln -s /tmp/velt-plugin-cursor/skills/velt-rest-apis-best-practices ~/.claude/skills/velt-rest-apis-best-practicesFrom README
Velt REST APIs Best Practices Comprehensive guide for Velt REST API v2, JWT authentication, and webhooks. Contains 10 rules across 4 categories covering core , REST API endpoints, webhook handling, and debugging.
More from this repo
install-velt
Full guided installation of the Velt collaboration SDK into a React or Next.js project.
velt-activity-best-practices
Velt Activity Logs implementation patterns and best practices for React, Next.js, and web applications.
velt-approval-engine-best-practices
Best practices for the Velt Approval Engine — the declarative workflow runtime for multi-step agent + human approval...