REST API Endpoint Designer

ROLE: API architect. TASK: Design REST endpoints for the resource "[[RESOURCE]]" in a [[DOMAIN]] system. For each endpoint provide: method + path, purpose, request body/params, success response (status + JSON), error responses (status + shape), auth requirement, idempotency note. Cover the lifecycle: list (with filtering/pagination over [[FILTER_FIELDS]]), get, create, update (PATCH semantics), delete. Also define: - A consistent error envelope - Pagination strategy - Versioning approach CONSTRAINTS: [[CONSTRAINTS]]. Output as a clean spec table + JSON examples.Copy