Action Items

Terminology: the action-plan block is the container (created via POST /api/v2/blocks with type: "action-plan"). The individual tasks inside it are called action items and are managed via the endpoints on this page.

Endpoints

Method	Path	Description
`GET`	`/api/v2/action-items?pageId={page_id}&blockId={block_id}`	List action items in a block
`POST`	`/api/v2/action-items`	Create action items
`PATCH`	`/api/v2/action-items/{action_item_id}`	Update an action item
`DELETE`	`/api/v2/action-items/{action_item_id}`	Delete an action item

Both pageId and blockId are mandatory for listing and creating. The blockId must point to an existing action-plan block. See Blocks to create one.

Action item fields

Field	Type	Notes
`title`	string	Required.
`description`	string
`status`	enum	`todo`, `in_progress`, `done`, `cancelled`
`startDate`	string	ISO 8601
`dueDate`	string	ISO 8601
`internal`	boolean	Hidden from buyers when `true`. Default `false`.
`assignees`	string[]	Emails. Org members linked internally; others added as external contacts.

List action items

GET /api/v2/action-items?pageId={page_id}&blockId={block_id}

curl "https://api.flowla.com/api/v2/action-items?pageId=<page_id>&blockId=<block_id>" \
  -H "x-flowla-api-key: YOUR_API_KEY"

import requests

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

const res = await fetch(
  "https://api.flowla.com/api/v2/action-items?pageId=<page_id>&blockId=<block_id>",
  { headers: { "x-flowla-api-key": "YOUR_API_KEY" } }
);

Create action items

POST /api/v2/action-items

pageId

string

required

The page containing the action-plan block.

blockId

string

required

The action-plan block to add action items to.

items

array

required

Array of action item objects.

Example

{
  "pageId": "<page_id>",
  "blockId": "<block_id>",
  "items": [
    {
      "title": "Review proposal",
      "description": "Check pricing and terms",
      "status": "in_progress",
      "startDate": "2026-05-28",
      "dueDate": "2026-06-01",
      "internal": false,
      "assignees": ["owner@example.com", "buyer@example.com"]
    },
    { "title": "Schedule kickoff call", "status": "todo" }
  ]
}

curl -X POST https://api.flowla.com/api/v2/action-items \
  -H "x-flowla-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pageId": "<page_id>",
    "blockId": "<block_id>",
    "items": [
      {
        "title": "Review proposal",
        "status": "in_progress",
        "dueDate": "2026-06-01",
        "assignees": ["buyer@example.com"]
      },
      { "title": "Confirm legal sign-off", "internal": true }
    ]
  }'

requests.post(
    "https://api.flowla.com/api/v2/action-items",
    headers={"x-flowla-api-key": "YOUR_API_KEY"},
    json={
        "pageId": "<page_id>",
        "blockId": "<block_id>",
        "items": [
            {
                "title": "Review proposal",
                "status": "in_progress",
                "dueDate": "2026-06-01",
                "assignees": ["buyer@example.com"],
            },
            {"title": "Confirm legal sign-off", "internal": True},
        ],
    },
)

await fetch("https://api.flowla.com/api/v2/action-items", {
  method: "POST",
  headers: {
    "x-flowla-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    pageId: "<page_id>",
    blockId: "<block_id>",
    items: [
      {
        title: "Review proposal",
        status: "in_progress",
        dueDate: "2026-06-01",
        assignees: ["buyer@example.com"],
      },
      { title: "Confirm legal sign-off", internal: true },
    ],
  }),
});

Update an action item

PATCH /api/v2/action-items/{action_item_id} All fields are optional. assignees replaces the full assignee list.

title

string

Updated title.

description

string

Updated description.

status

"todo" | "in_progress" | "done" | "cancelled"

New status.

startDate

string

ISO 8601 start date.

dueDate

string

ISO 8601 due date.

internal

boolean

Whether the action item is hidden from buyers.

assignees

string[]

Replaces the full assignee list. Pass an empty array to remove all assignees.

Example

{ "status": "done", "assignees": ["alex@ourcompany.com"] }

curl -X PATCH https://api.flowla.com/api/v2/action-items/<action_item_id> \
  -H "x-flowla-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "done"}'

requests.patch(
    "https://api.flowla.com/api/v2/action-items/<action_item_id>",
    headers={"x-flowla-api-key": "YOUR_API_KEY"},
    json={"status": "done"},
)

await fetch("https://api.flowla.com/api/v2/action-items/<action_item_id>", {
  method: "PATCH",
  headers: {
    "x-flowla-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ status: "done" }),
});

Delete an action item

DELETE /api/v2/action-items/{action_item_id}

curl -X DELETE https://api.flowla.com/api/v2/action-items/<action_item_id> \
  -H "x-flowla-api-key: YOUR_API_KEY"

requests.delete(
    "https://api.flowla.com/api/v2/action-items/<action_item_id>",
    headers={"x-flowla-api-key": "YOUR_API_KEY"},
)

await fetch("https://api.flowla.com/api/v2/action-items/<action_item_id>", {
  method: "DELETE",
  headers: { "x-flowla-api-key": "YOUR_API_KEY" },
});

Getting started

Rooms

Structure

Automation

Lookups

Action Items

Endpoints

Action item fields

List action items

Create action items

Update an action item

Delete an action item

​Endpoints

​Action item fields

​List action items

​Create action items

​Update an action item

​Delete an action item

Endpoints

Action item fields

List action items

Create action items

Update an action item

Delete an action item