Rest Api Design

Prefer the existing API style. Check HTTP semantics, stable contracts, validation, consistent errors, pagination/filter/sort, idempotency for retryable writes, compatibility/versioning and resource-level authorization. Avoid changing established style without strong reason.

Read workflow.md when the task reaches domain-specific behavior, compatibility, failure, or verification boundaries.