Operations API

List Boards

Optional parameters: - tool_key: Filter boards by tool (e.g., 'website_builder', 'analytics')

Create Board

Get Board

Update Board

List Cards

Filters (all optional, combined with AND): group_id, board_id, status, tag_id, owner_id, search, due and start date ranges, priority, overdue, source, completed. Completed cards are included unless include_completed is false. Date-only bounds cover the whole day.

Create Card

Update Card

Delete Card

Reorder Cards

Get Card

One card of this project with its group, board, tag, owner, comment counts, the last 20 activities and, for a recurring card, the date of the next occurrence.

Complete Card

Sets status closed and completed_at, and moves the card into the board's done group when the board has one. A recurring card gets its next occurrence in the group the card was in (dates moved by the rule, never before today: rule dates already past are skipped; recurrence copied, recurrence_parent_id = the first card of the series, source system). Completing a completed card changes nothing (already_completed true). Cards copied from a master board can be completed too.

Card Agenda

Open cards in buckets for planning, in the project's time zone (else the user's, else the app's): overdue due date passed (all-day: before today; timed: before now) today due today, starting today, or started earlier without a due date upcoming due or starting in the next 7 days counts also gives no_date (open cards without due date and start) and snoozed (open cards snoozed now; they are left out of the buckets). Completed cards are never listed.

Card Calendar

Cards whose start_at or due_date falls between from and to (inclusive, at most 92 days, in the project's time zone), plus the later occurrences of open recurring cards projected into the range. Projected items have virtual: true, id null and card_id of the card they repeat; they become real cards one at a time, when the card before is completed. Every item has calendar_date: the date it shows on.

Move Card

List Comments

Create Comment

List Groups

Create Group

Update Group

Delete Group

Reorder Groups

List Tags

Create Tag

List Tour Cards

Used by the frontend to determine which guided tours to trigger.

Update Tour Card

Scoped to master tour cards only — no tool subscription required.

Dismiss All Tour Cards

List Widget Cards

Required parameters: - tool_key: Filter cards by tool (e.g., 'website_builder', 'analytics')

Update Widget Card

Tool access is checked based on the card's board tool_key. No AuthorizeProjectHasToolAccess middleware needed.

Get Setup Guide Progress

Returns counts of project cards that have an evaluation_check set (i.e. cards tied to a funnel step). Used by the top-bar Setup Guide badge to show the user X/Y completion. Optional `tool_key` filters the count to one tool's cards.