Document two new endpoints (ArrangeMultiple and SetOutOfOrder) + mark old Arrange as deprecated.

Author: cjavad

source/includes/_printer_groups.md

@@ -160,6 +160,71 @@ curl https://api.simplyprint.io/{id}/groups/Delete?group=123 \
 
 ## Arrange printers and groups
 
+```shell
+# Move multiple printers and groups in a single request
+curl https://api.simplyprint.io/{id}/groups/ArrangeMultiple \
+  -X POST \
+  -H 'accept: application/json' \
+  -H 'X-API-KEY: {API_KEY}' \
+  -d '{
+    "group": [
+      {"id": 123, "position": 1},
+      {"id": 456, "position": 0}
+    ],
+    "printer": [
+      {"id": 1234, "group": 123, "position": 0},
+      {"id": 1235, "position": 2},
+      {"id": 1236, "group": 456}
+    ]
+  }'
+```
+
+> Success response
+
+```json
+{
+  "status": true,
+  "message": null
+}
+```
+
+You can arrange the ordering of printers in printer groups, or the order of groups themselves. This endpoint allows you to move multiple printers and groups in a single request:
+
+1. **Set the position of one or more printer groups** - Use the `group` array to change the sort order of groups
+2. **Move printers between groups** - Use `printer[].group` to transfer printers from one group to another
+3. **Reorder printers within a group** - Use `printer[].position` to set new positions (omit `printer[].group` to keep in current group, or combine both to move to a new group at a specific position)
+
+`POST /{id}/groups/ArrangeMultiple`
+
+| Required permissions |
+|----------------------|
+| `printer_edit`       |
+
+### Request Body
+
+| Parameter              | Type      | Required | Description                                                                                    |
+|------------------------|-----------|----------|------------------------------------------------------------------------------------------------|
+| `group`                | array     | no       | Array of groups to move.                                                                       |
+| `group[].id`           | integer   | yes      | The ID of the group to move.                                                                   |
+| `group[].position`     | integer   | yes      | The new position for the group (0-indexed).                                                    |
+| `printer`              | array     | no       | Array of printers to move.                                                                     |
+| `printer[].id`         | integer   | yes      | The ID of the printer to move.                                                                 |
+| `printer[].group`      | integer   | no       | The new group to move the printer into. If omitted, reorders the printer within its current group. |
+| `printer[].position`   | integer   | no       | The new position for the printer (0-indexed). If omitted when changing groups, printer is placed at end. |
+
+### Response
+
+| Parameter | Type    | Description                           |
+|-----------|---------|---------------------------------------|
+| `status`  | boolean | `true` if the request was successful. |
+| `message` | string  | Error message if `status` is `false`. |
+
+## Arrange individual printer or group (deprecated)
+
+<aside class="warning">
+This endpoint is deprecated. Use <a href="#arrange-printers-and-groups">ArrangeMultiple</a> instead for better performance and batch operations.
+</aside>
+
 ```shell
 # Move printer within a group or to another group
 curl https://api.simplyprint.io/{id}/groups/Arrange?pid=1234&group=123 \
@@ -218,12 +283,6 @@ This endpoint can arrange printers within groups, move printers between groups,
 | `from`    | integer/null | yes      | Current position. Set to `null` when moving printer to a different group.              |
 | `to`      | integer      | yes      | New position in the target group or new group sort position.                           |
 
-### Use Cases
-
-1. **Move printer within same group**: Provide `pid`, `group` (current group), `from` (current position), and `to` (new position)
-2. **Move printer to different group**: Provide `pid`, `group` (target group), `from: null`, and `to` (position in target group)
-3. **Change group sort order**: Omit `pid`, provide `group`, `from` (current group position), and `to` (new group position)
-
 ### Response
 
 | Parameter | Type    | Description                           |

source/includes/_printers.md

@@ -1012,6 +1012,51 @@ curl https://api.simplyprint.io/{id}/printers/autoprint/SetClearedBedsAmount \
 | `status`  | boolean | `true` if the request was successful. |
 | `message` | string  | Error message if `status` is `false`. |
 
+## Set printers out of order
+
+```shell
+curl https://api.simplyprint.io/{id}/printers/SetOutOfOrder?pid=1234,1235 \
+  -X POST \
+  -H 'accept: application/json' \
+  -H 'X-API-KEY: {API_KEY}'
+```
+
+> Success response
+
+```json
+{
+  "status": true,
+  "message": null
+}
+```
+
+<aside class="notice">
+  This endpoint requires the <b>Print Farm</b> plan.
+</aside>
+
+| Required permission |
+|---------------------|
+| `printer_edit`      |
+
+This endpoint can be used to set one or multiple printers as out of order.
+
+### Request
+
+`POST /{id}/printers/SetOutOfOrder`
+
+#### Query parameters
+
+| Parameter | Type      | Required | Description                                                                      |
+|-----------|-----------|----------|----------------------------------------------------------------------------------|
+| `pid`     | integer[] | yes      | The ID(s) of the printer to set out of order. Comma separated list of printer IDs. |
+
+### Response
+
+| Field     | Type    | Description                         |
+|-----------|---------|-------------------------------------|
+| `status`  | boolean | True if the request was successful. |
+| `message` | string  | Error message if `status` is false. |
+
 ## Cancel reasons
 
 | ID | Description                        |