# Reorder the sidebar folders

Sets the folders' order for the whole workspace. `order` lists EVERY folder id once, first to last; a list that leaves one out or names one twice is refused. Answers the folders as the read does. Any seat.

Access class: `workspace`.

## Endpoint

`PUT /v1/workspace/sidebar-folders/order`

## Request body

Content type: `application/json`.

```json
{
  "order": [
    "string"
  ]
}
```

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "folders": [
      {
        "createdAt": "2026-01-01T00:00:00Z",
        "createdByAccountId": "",
        "id": "",
        "label": "string",
        "position": 1.5,
        "targets": [
          "string"
        ],
        "updatedAt": "2026-01-01T00:00:00Z"
      }
    ]
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
