Users API

The authenticated user and user metadata.

📄️List users

Answers the full company roster from a short-lived cache, so very recent user changes may lag briefly. Use `GET /api/v1/users/me/` for the caller’s own record.

📄️Get current user

Returns the caller in the same item shape as the `GET /api/users/` list.

📄️Get user metadata

Reads the metadata map fresh from the database rather than the session cache. Keys are written via `POST /api/v1/users/me/metadata/`.

📄️Merge user metadata

Merges a single key-value pair into the existing metadata, other keys are preserved. Also invalidates the caller’s session verification cache so the new metadata is visible on the next request.