> 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.

## Work order notes and work items

### New: Work order notes endpoints

You can now create and list notes directly on work orders.

| Method | Path                               | Description                    |
| ------ | ---------------------------------- | ------------------------------ |
| `POST` | `/work-orders/{workOrderId}/notes` | Add a note to a work order     |
| `GET`  | `/work-orders/{workOrderId}/notes` | List all notes on a work order |

#### Create a note

```
POST /work-orders/{workOrderId}/notes
```

```json
{
  "body": "Panels installed. Awaiting inspection sign-off.",
  "fileIds": []
}
```

Response:

```json
{
  "id": 4029970,
  "note": "Panels installed. Awaiting inspection sign-off.",
  "createdAt": "2026-04-15T22:41:03.548Z",
  "updatedAt": "2026-04-15T22:41:03.548Z"
}
```

#### List notes

```
GET /work-orders/{workOrderId}/notes?page=1&page_size=20
```

```json
{
  "notes": [
    {
      "id": 4029970,
      "note": "Panels installed. Awaiting inspection sign-off.",
      "createdAt": "2026-04-15T22:41:03.548Z",
      "createdByUser": {
        "id": 42,
        "firstName": "Jane",
        "lastName": "Doe",
        "email": "jane@example.com"
      }
    }
  ],
  "totalCount": 1
}
```

### New: `workItems` on work order responses

`GET /work-orders/{workOrderId}` now includes a `workItems` array containing Blueprint workflow items linked to the work order. Two types are supported:

* `FORM` — a form instance (e.g. site survey, roof mount checklist)
* `FILE_REQUEST` — a document upload request (e.g. shade report)

```json
{
  "id": 2025433,
  "title": "[BP] Tech site audit (post-sale)",
  "workItems": [
    {
      "type": "FORM",
      "id": 1236647,
      "name": "[BP] Site Survey - Roof Mount",
      "templateId": 50,
      "status": "OPEN",
      "isCompleted": false,
      "completedAt": null,
      "dueDate": null
    },
    {
      "type": "FILE_REQUEST",
      "id": 2556,
      "name": "Shade Report",
      "status": "IN_PROGRESS"
    }
  ]
}
```

If no work items are linked, `workItems` is an empty array.