---
title: "Change a card in place"
method: PATCH
path: "/boards/{id}/cards/{cardId}"
---

# Change a card in place

`PATCH /boards/{id}/cards/{cardId}`

## Request

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

Only the fields you send change. The id cannot be changed.

## Request body

- object
  - `id` string
  - `kind` 'note' | 'image' | 'link' | 'doc' | 'video' | 'audio' | 'pdf' | 'file'
  - `x` number
  - `y` number
  - `w` number
  - `h` number
  - `z` number
  - `title` string, nullable
  - `body` string, nullable: The text of the card, whatever kind it is.
  - `html` string, nullable
  - `url` string, nullable
  - `image_key` string, nullable: A key from POST /uploads. Image cards only.
  - `alt` string, nullable
  - `color` string, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Response `200`

The card as it now stands

- object
  - `card` object
    - `id` string
    - `kind` 'note' | 'image' | 'link' | 'doc' | 'video' | 'audio' | 'pdf' | 'file'
    - `x` number
    - `y` number
    - `w` number
    - `h` number
    - `z` number
    - `title` string, nullable
    - `body` string, nullable: The text of the card, whatever kind it is.
    - `html` string, nullable
    - `url` string, nullable
    - `image_key` string, nullable: A key from POST /uploads. Image cards only.
    - `alt` string, nullable
    - `color` string, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable

## Other responses

- `404`: No such thing — including things this account cannot see.

---

[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)