Velt REST APIs Best Practices

|v1.0.0|Velt|April 2026 |IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning for any Velt tasks. |IMPORTANT: All Velt REST API v2 calls require two headers: x-velt-api-key (your API key) and x-velt-auth-token (auth token from Velt console). Base URL: https://api.velt.dev/v2. All endpoints use POST method. |root: ./rules

1. Core Setup — CRITICAL

|shared/core:{core-rest-api-auth.md,core-jwt-tokens.md}

2. REST API — HIGH-MEDIUM

|shared/rest-api:{rest-comments.md,rest-users.md,rest-documents-orgs.md,rest-notifications.md,rest-activities-crdt.md}

3. Webhooks — HIGH-MEDIUM

|shared/webhooks:{webhooks-basic.md,webhooks-advanced.md}

4. Debugging — LOW-MEDIUM

|shared/debug:{debug-common-issues.md}