# Make a sidebar folder

Makes a folder named `label` at the end of the rail, or, when the workspace already has a folder by that name (casing and padding aside), answers that one with 200 instead of 201. Either way the optional `targets` (route words, or "board:<board id>") are filed at the folder's foot, moving out of any other folder: "put this board in the Nonprofit folder, made if missing" in one call. A board the caller cannot open is refused as not found. Any seat.

Access class: `workspace`.

## Endpoint

`POST /v1/workspace/sidebar-folders`

## Request body

Content type: `application/json`.

```json
{
  "label": "string",
  "targets": [
    "string"
  ]
}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "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"
}
```
