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`	List action items
`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

Action item fields

Field	Type	Notes
`id`	string
`blockId`	string \| null	ID of the action-plan block this item belongs to
`title`	string	Required on create.
`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`	object[]	`{ userId, email, name }` per assignee
`completedAt`	string \| null	ISO 8601
`createdAt`	string	ISO 8601
`updatedAt`	string	ISO 8601

List action items

GET /api/v2/action-items Returns action items scoped to a room, page, or specific block. All scope parameters are optional, but at least one should be provided. If blockId is set, pageId must also be set (otherwise the API returns 400).

Scoping

`roomId`	`pageId`	`blockId`	Result
✓	—	—	All action items in the room
—	✓	—	All action items on the page
—	✓	✓	Action items in the specific block
—	—	✓	400 Bad Request

Query parameters

string

Room ID — returns all action items across the room.

string

Page ID — returns all action items on the page.

string

Action-plan block ID — returns items in that block. Requires pageId.

number

Page number (default: 1).

number

Results per page (default: 100, max: 1000).

Response

{
  "items": [ ... ],
  "totalRecords": 42,
  "totalPages": 1
}

curl "https://api.flowla.com/api/v2/action-items?roomId=<room_id>" \
  -H "x-flowla-api-key: YOUR_API_KEY"

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

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={"roomId": "<room_id>"},
)

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

Create action items

POST /api/v2/action-items

string

required

The page containing the action-plan block.

string

required

The action-plan block to add action items to.

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" },
      { "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", "dueDate": "2026-06-01"},
            {"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", dueDate: "2026-06-01" },
      { 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.

string

Updated title.

string

Updated description.

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

New status.

string

ISO 8601 start date.

string

ISO 8601 due date.

boolean

Whether hidden from buyers.

string[]

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

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

Scoping

Query parameters

Response

Create action items

Update an action item

Delete an action item

​Endpoints

​Action item fields

​List action items

​Scoping

​Query parameters

​Response

​Create action items

​Update an action item

​Delete an action item

Endpoints

Action item fields

List action items

Scoping

Query parameters

Response

Create action items

Update an action item

Delete an action item