| Rule | Detail |
|---|---|
| Protocol | HTTPS in production. UTF-8 JSON bodies. |
| Version | In the path: /api/v1. Not in a header. |
| IDs | Resource id values are UUIDs. |
| Timestamps | ISO-8601 UTC (2026-08-20T15:00:00.000Z). |
| Null | Explicit null means no value. Omitted on PATCH means leave unchanged. |
| Extra keys | Rejected on write (additionalProperties: false). |
| Unknown response keys | Ignore them. Additive fields may appear on /api/v1. |
| Methods | GET list/get, POST create, PATCH update. DELETE only on webhooks and inbox tags/participants. |
GuidesConventions
Conventions
HTTPS, JSON, /api/v1 in the path, UUIDs, UTC timestamps.