---
title: "Block Action"
method: PUT
path: "/v3.0/boards/{boardSlug}/blocks/{blockSlug}/"
tags: ["boards"]
---

# Block Action

`PUT /v3.0/boards/{boardSlug}/blocks/{blockSlug}/`

## Request

- Base URL: `https://api.formaloo.me`
- URL: `https://api.formaloo.me/v3.0/boards/{boardSlug}/blocks/{blockSlug}/`
- Auth: none declared. Required headers: `x-api-key`

# Setting blocks in a menu item for a menu block

If a menu item under your menu block is supposed to open one or more blocks, the menu item's type should be `block` and you should send the list of blocks' slug inside it. For example:
‍‍‍
``` json
{
    "items": [
        {
            "type": "block",
            "title": "Show list of blocks",
            "blocks": [
                "block_1_slug",
                "block_2_slug",
                "block_3_slug,
            ]
        }
    ]
}
```

The response contains the basic data for each block.

## Path parameters

- `blockSlug` string, required
- `boardSlug` string, required

## Headers

- `x-api-key` string, required
- `x-workspace` string

## Request body

- UpdateBlockRequest
  - `form` string
  - `position` integer
  - `title` string, nullable
  - `location` 'left-sidebar' | 'right-sidebar' | 'header' | 'footer' | 'main' | 'non-primary'
  - `color` string, nullable: color of block
  - `config` object, nullable
  - `workspace_access` 'owner' | 'admin' | 'team_member' | 'guest'
  - `access_settings` object, nullable
  - `roles` integer[]: roles that have access to this block.

## Response `200`

- UpdateBlock
  - `slug` string, nullable
  - `form` string
  - `type` 'generic' | 'menu' | 'stats' | 'form_display' | 'form_result' | 'form_charts' | 'report' | 'kanban' | 'content' | 'ai_summary'
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `position` integer
  - `title` string, nullable
  - `location` 'left-sidebar' | 'right-sidebar' | 'header' | 'footer' | 'main' | 'non-primary'
  - `color` string, nullable: color of block
  - `config` object, nullable
  - `workspace_access` 'owner' | 'admin' | 'team_member' | 'guest'
  - `access_settings` object, nullable
  - `roles` integer[]: roles that have access to this block.

---

[API](https://skmtc.dev/formaloo/apis/formaloo-api-documentation.md) · [All operations](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/revisions/47b268aeb656?raw)