---
title: "Update properties of an existing Block"
method: PATCH
path: "/{username}/dashboards/{dashboard_id}/blocks/{id}"
tags: ["Blocks"]
---

# Update properties of an existing Block

`PATCH /{username}/dashboards/{dashboard_id}/blocks/{id}`

## Path parameters

- `username` string, required
- `dashboard_id` string, required
- `id` string, required

## Request body

- object
  - `name` string
  - `description` string
  - `key` string
  - `dashboard_id` number
  - `visual_type` string
  - `column` number
  - `row` number
  - `size_x` number
  - `size_y` number
  - `block_feeds` object[]
    - `feed_id` string
    - `group_id` string
  - `properties` object

## Response `200`

Updated Block

- Block
  - `name` string
  - `description` string
  - `key` string
  - `visual_type` string
  - `column` number
  - `row` number
  - `size_x` number
  - `size_y` number
  - `block_feeds` BlockFeed[]
    - `id` string
    - `feed` Feed
      - `id` number
      - `name` string
      - `key` string
      - `group` object
      - `groups` ShallowGroup[]
        - `id` number
        - `name` string
        - `description` string
        - `created_at` string
        - `updated_at` string
      - `description` string
      - `details` object — Additional details about this feed.
        - `shared_with` object[] — Access control list for this feed
        - `data` object
          - `first` object
          - `last` object
          - `count` integer — Number of data points stored by this feed.
      - `unit_type` string
      - `unit_symbol` string
      - `history` boolean
      - `visibility` 'private' | 'public'
      - `license` string
      - `enabled` boolean
      - `last_value` string
      - `status` string
      - `status_notify` boolean — Is status notification active?
      - `status_timeout` integer — Status notification timeout in minutes.
      - `created_at` string
      - `updated_at` string
    - `group` Group
      - `id` number
      - `name` string
      - `description` string
      - `feeds` Feed[]
        - `id` number
        - `name` string
        - `key` string
        - `group` object
        - `groups` ShallowGroup[]
          - `id` number
          - `name` string
          - `description` string
          - `created_at` string
          - `updated_at` string
        - `description` string
        - `details` object — Additional details about this feed.
          - `shared_with` object[] — Access control list for this feed
          - `data` object
            - `first` object
            - `last` object
            - `count` integer — Number of data points stored by this feed.
        - `unit_type` string
        - `unit_symbol` string
        - `history` boolean
        - `visibility` 'private' | 'public'
        - `license` string
        - `enabled` boolean
        - `last_value` string
        - `status` string
        - `status_notify` boolean — Is status notification active?
        - `status_timeout` integer — Status notification timeout in minutes.
        - `created_at` string
        - `updated_at` string
      - `created_at` string
      - `updated_at` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Server Error

---

[API](https://skmtc.net/adafruit/apis/adafruit-io-rest-api.md) · [All operations](https://skmtc.net/adafruit/apis/adafruit-io-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adafruit/adafruit-io-rest-api/versions/b16cd6123537/schema)