Blocks

Endpoints

Method	Path	Description
`POST`	`/api/v2/blocks`	Create blocks
`GET`	`/api/v2/blocks?pageId={page_id}&groupId={group_id}`	List blocks in a group
`PATCH`	`/api/v2/blocks/{block_id}`	Update a block
`DELETE`	`/api/v2/blocks/{block_id}?pageId={page_id}`	Delete a block

Block type is immutable after creation. To change a block’s type, delete it and create a new one.

Block types

Type	Use it for	Content field
`text`	Rich text	`content` — accepts Markdown
`image`	Images	`url` — auto-stored in Flowla S3
`embed`	Web pages, iframes	`url`
`link`	Clickable URLs	`url`
`pdf`	PDF documents	`url` — auto-stored in Flowla S3
`action-plan`	Task checklists	(no extra fields)

Create blocks

POST /api/v2/blocks Blocks are organized into columns. Each element of columns is a vertical stack of blocks; multiple elements appear side by side.

string

required

The page the group belongs to.

string

required

The group to add blocks to.

array

required

Array of column objects. Each column contains a blocks array stacked vertically. Multiple columns appear side by side on the page.

Show Column object fields

array

required

Array of block objects for this column.

Show Block object fields

required

Block type. Immutable after creation.

string

Text content for text blocks. Accepts Markdown — bold, italic, headings, lists, tables, blockquotes, and code blocks are converted automatically.

string

URL for image, embed, link, and pdf blocks. For image and pdf, any public URL is accepted — the file is automatically fetched and stored in Flowla S3.

Layout examples

Single column (vertical stack)

{
  "pageId": "<page_id>",
  "groupId": "<group_id>",
  "columns": [
    {
      "blocks": [
        { "type": "text", "content": "## Welcome\n\nThis is **bold** text." },
        { "type": "image", "url": "https://cdn.example.com/banner.png" }
      ]
    }
  ]
}

Two side-by-side columns

{
  "pageId": "<page_id>",
  "groupId": "<group_id>",
  "columns": [
    { "blocks": [{ "type": "text", "content": "Left column" }] },
    { "blocks": [{ "type": "image", "url": "https://cdn.example.com/img.png" }] }
  ]
}

text

{
  "pageId": "<page_id>",
  "groupId": "<group_id>",
  "columns": [
    { "blocks": [{ "type": "text", "content": "Welcome to the room." }] }
  ]
}

The content field accepts Markdown. Formatting like **bold**, # Heading, bullet lists, and tables are rendered correctly.

image

{
  "pageId": "<page_id>",
  "groupId": "<group_id>",
  "columns": [
    { "blocks": [{ "type": "image", "url": "https://cdn.example.com/banner.png" }] }
  ]
}

The image is automatically fetched from the provided URL and stored in Flowla S3.

embed

{
  "pageId": "<page_id>",
  "groupId": "<group_id>",
  "columns": [
    { "blocks": [{ "type": "embed", "url": "https://example.com/page" }] }
  ]
}

link

{
  "pageId": "<page_id>",
  "groupId": "<group_id>",
  "columns": [
    { "blocks": [{ "type": "link", "url": "https://example.com/pricing" }] }
  ]
}

pdf

{
  "pageId": "<page_id>",
  "groupId": "<group_id>",
  "columns": [
    { "blocks": [{ "type": "pdf", "url": "https://cdn.example.com/proposal.pdf" }] }
  ]
}

The PDF is automatically fetched and stored in Flowla S3.

action-plan

{
  "pageId": "<page_id>",
  "groupId": "<group_id>",
  "columns": [
    { "blocks": [{ "type": "action-plan" }] }
  ]
}

Once created, use the Action Items endpoints to add tasks to this block.

curl -X POST https://api.flowla.com/api/v2/blocks \
  -H "x-flowla-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pageId": "<page_id>",
    "groupId": "<group_id>",
    "columns": [{ "blocks": [{ "type": "action-plan" }] }]
  }'

import requests

requests.post(
    "https://api.flowla.com/api/v2/blocks",
    headers={"x-flowla-api-key": "YOUR_API_KEY"},
    json={
        "pageId": "<page_id>",
        "groupId": "<group_id>",
        "columns": [{"blocks": [{"type": "action-plan"}]}],
    },
)

await fetch("https://api.flowla.com/api/v2/blocks", {
  method: "POST",
  headers: {
    "x-flowla-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    pageId: "<page_id>",
    groupId: "<group_id>",
    columns: [{ blocks: [{ type: "action-plan" }] }],
  }),
});

List blocks

GET /api/v2/blocks?pageId={page_id}&groupId={group_id}

curl "https://api.flowla.com/api/v2/blocks?pageId=<page_id>&groupId=<group_id>" \
  -H "x-flowla-api-key: YOUR_API_KEY"

response = requests.get(
    "https://api.flowla.com/api/v2/blocks",
    headers={"x-flowla-api-key": "YOUR_API_KEY"},
    params={"pageId": "<page_id>", "groupId": "<group_id>"},
)

Update a block

PATCH /api/v2/blocks/{block_id}

string

required

The page the block belongs to.

string

Updated text content (for text blocks). Accepts Markdown.

string

Updated URL (for image, embed, link, pdf blocks). For image and pdf, the file is automatically fetched and stored in Flowla S3.

Example

{ "pageId": "<page_id>", "content": "Updated **text** content" }

curl -X PATCH https://api.flowla.com/api/v2/blocks/<block_id> \
  -H "x-flowla-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pageId": "<page_id>", "content": "Updated text content"}'

requests.patch(
    "https://api.flowla.com/api/v2/blocks/<block_id>",
    headers={"x-flowla-api-key": "YOUR_API_KEY"},
    json={"pageId": "<page_id>", "content": "Updated text content"},
)

Delete a block

DELETE /api/v2/blocks/{block_id}?pageId={page_id}

If the block is an action-plan block, all its action items are deleted too.

curl -X DELETE "https://api.flowla.com/api/v2/blocks/<block_id>?pageId=<page_id>" \
  -H "x-flowla-api-key: YOUR_API_KEY"

requests.delete(
    "https://api.flowla.com/api/v2/blocks/<block_id>",
    headers={"x-flowla-api-key": "YOUR_API_KEY"},
    params={"pageId": "<page_id>"},
)

Getting started

Rooms

Structure

Action Items

Automation

Lookups

Endpoints

Block types

Create blocks

Layout examples

List blocks

Update a block

Delete a block

​Endpoints

​Block types

​Create blocks

​Layout examples

​List blocks

​Update a block

​Delete a block

Endpoints

Block types

Create blocks

Layout examples

List blocks

Update a block

Delete a block