## Set the order of a configuration collection (tenant:forge:write and maintainer, or tenant:forge:admin)

`POST /api/forge/v1/projects/{key}/config/reorder`

Module: Forge · operationId: `reorderForgeConfig` · Tag: Configuration · Auth: access token (`Authorization: Bearer <accessToken>`)

Requires `tenant:forge:admin`, or `tenant:forge:write` and project role maintainer or admin. `ids` lists every row of the collection once; labels sort by name and cannot be reordered. The order of `ownerships` is their precedence, a later ownership wins a path both match (as in CODEOWNERS) or an item both match.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `key` | path | string | yes | Project key (e.g. APP) |

### Request body

`application/json` (required)

- `collection` (string, required): (one of `statuses`, `workflows`, `item-types`, `custom-fields`, `item-templates`, `section-defs`, `ownerships`, `teams`)
- `ids` (array of string (uuid), required)

Example:

```json
{
  "collection": "statuses",
  "ids": [
    "5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f01",
    "5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f02",
    "5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f03",
    "5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f04",
    "5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f05",
    "5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f06"
  ]
}
```

### Responses

- **204** Reordered
- **400** Error (`application/json`)
- **403** Error (`application/json`)
- **404** Error (`application/json`)

### Example request

```bash
curl -X POST 'https://api.mbcom.cloud/api/forge/v1/projects/string/config/reorder' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"collection":"statuses","ids":["5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f01","5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f02","5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f03","5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f04","5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f05","5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f06"]}'
```
