> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.coperniq.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.coperniq.io/_mcp/server.

## Summary

Today’s release adds request/client work order endpoints, consolidates visit schemas, and completes the comments API across projects/requests/clients. We also improved the docs’ structure and fixed operation IDs for navigation.

### What’s new?

* Request Work Orders: List, create, and update request work orders.
* Client Work Orders: List and create client work orders.
* Comments API: List/create/update/delete comments for projects, requests, and clients.

### Changes

* Work Orders
  * POST `/projects/{projectId}/work-orders` requires `templateId` and accepts optional `phaseInstanceId` (phase must be started when provided).
  * POST `/requests/{requestId}/work-orders` requires `templateId`, optional `phaseInstanceId` (phase doesn’t need to be started).
  * POST `/clients/{clientId}/work-orders` requires `templateId` (no phases).
  * GET `/requests/{requestId}/work-orders` lists request work orders.
  * PATCH `/requests/{requestId}/work-orders/{workOrderId}` updates a request work order.
* Comments
  * Projects: GET `/projects/{projectId}/comments`, POST `/projects/{projectId}/comments`, PATCH `/projects/{projectId}/comment/{commentId}`, DELETE `/projects/{projectId}/comment/{commentId}`.
  * Requests: GET `/requests/{requestId}/comments`, POST `/requests/{requestId}/comments`, PATCH `/requests/{requestId}/comment/{commentId}`, DELETE `/requests/{requestId}/comment/{commentId}`.
  * Clients: GET `/clients/{clientId}/comments`, POST `/clients/{clientId}/comments`, PATCH `/clients/{clientId}/comment/{commentId}`, DELETE `/clients/{clientId}/comment/{commentId}`.
* Projects
  * GET `/projects/{projectId}` includes `phaseInstances` array (phase data).
* Requests
  * GET `/requests/{requestId}` includes `phaseInstances` array (phase data).
* Catalog Items
  * Cleaned up examples and aligned schemas with public shape.

### Notes

* For project work order creation, when `phaseInstanceId` is provided, the phase must already be started.
* Request work order creation does not require a started phase.