---
title: "Rename, change view, or reparent"
method: PATCH
path: "/boards/{id}"
---

# Rename, change view, or reparent

`PATCH /boards/{id}`

## Request

- Base URL: `https://clusters.soleilpictures.com/api/v1`
- URL: `https://clusters.soleilpictures.com/api/v1/boards/{id}`
- Auth: HTTP bearer

## Request body

- object
  - `name` string
  - `view` 'canvas' | 'list'
  - `parent_board_id` string, uuid, nullable: null moves it to the top level. Cycles are refused with 409.

## Response `200`

The board as it now stands

- object
  - `board` object
    - `id` string, uuid
    - `name` string
    - `workspace_id` string, uuid
    - `parent_board_id` string, uuid, nullable
    - `view` 'canvas' | 'list'
    - `deleted` boolean
    - `created_at` string, date-time
    - `updated_at` string, date-time, nullable
    - `scheduled_date` string, date, nullable: The calendar date this board sits on, if any.
    - `scheduled_end` string, date, nullable: Inclusive end of a multi-day block. Null for a single day.
    - `day_label` string, nullable: The durable half of a scheduled day's name, e.g. "Day 12". The date is never stored in the name.
    - `sched_status` 'draft' | 'published' | 'cancelled'
    - `sched_version` integer: Bumped on publish. Only a published board notifies its readers when it moves.
    - `sched_published_at` string, date-time, nullable

## Other responses

- `409`: The reparent was refused — usually because it would make a cycle

---

[API](https://skmtc.dev/soleilpictures/apis/soleil-clusters-api.md) · [All operations](https://skmtc.dev/soleilpictures/apis/soleil-clusters-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soleilpictures/apis/soleil-clusters-api/revisions/1d426d587bf3?raw)