Conventions
A few conventions apply across every Cohabit API and this portal itself.
- JSON everywhere. Requests and responses are
application/jsonunless documented otherwise. - Timestamps are ISO 8601, always in UTC.
- IDs are UUIDs (v4), returned as strings.
- Errors are returned as
{ "error": "<code>", "error_description": "<human readable message>" }, matching the OAuth 2.0 error format wherever an endpoint is OIDC-related.
Specific endpoint conventions (pagination, rate limits, versioning) will be documented here once the first product API ships.