Instantboard

Delete a card by id or unique id prefix.

Get one card by global id, unique id prefix, board number (#N or N), or card URL. Call this when the user mentions a card so the card view can render. board_id may be omitted when card_id is a card URL (/b/{boardId}?card={cardId}).

List cards on a board. Archived cards are omitted unless include_archived is true. Optional column_id (id or column title), tag (case-insensitive), and assignee filters combine with AND. assignee is a member user id, display name, or email, "me" for the signed-in user, or "unassigned".

Search cards on a board. Matches title, description, tags, and card numbers the same way as the board filter: 33 finds #33 and #331, and #33 does the same. Archived cards are omitted unless include_archived is true.

Restore an archived card to the board.

Update card title, description, tags, assignee, and/or move to another column. Use tags to replace all tags; add_tags and remove_tags to merge. Pass if_column (column id or title) to claim the card. The update is always sent. It applies only while the card is still in that column. A lost claim returns code conflict with the current column and sends no event.

List board chat. Without card_id, returns the latest 200 messages (the sidebar). Pass card_id for the full card thread.

Post a board chat message. Set card_id to post on a card thread (mirrored into global chat). When posting as an agent, set agent_name and agent_icon_key.

Add a column to a board.

Remove a column (and its cards) from a board.

List columns on a board. Each column includes workflow: short text for how agents should use that column. Follow it. Empty workflow means the column has no extra rule.

Rename a column or update its view limit, colour, or agent workflow.

Full board state (columns and cards) for a board you can access.

List boards you own or are a member of.

Read the project overview for one board. The overview is a plain-language page about the project, written from the cards. It is a map of the product for someone who does not build it. It is not a runbook, and it is not a description of the source code. Call this when you are working on the product and a gap is already in front of you: what the product is, what has shipped, what is still an idea, or how the pieces fit. Use the page to fill that gap. Do not restate the page, and do not invent work the board did not ask for. Project notes override the page when they conflict. To record a gap the cards leave out, or a decision that should beat a card, call overview_update_notes. cardNumbers on a paragraph are the cards that support that paragraph. Call card_get on one of those before you change it. changed lists cards saved after the page was written, up to 10, and changedMore is the rest. Read a changed card before you trust a paragraph it would affect. document is null when this board has no overview yet. When run.status is running, a replacement is being written; keep using document until that finishes. Pictures illustrate the page. Do not download image bytes into the conversation.

Replace the project notes on a board. Project notes are what the cards do not say, or what should win when a card disagrees. The next overview follows these notes. Saving notes does not rewrite the page. Call overview_get first. notes replaces the whole note. Send the full text you want kept, including anything already there that should stay. Write a short note for a real gap: a fact the cards miss, or a decision that overrides a card. Do not paste the overview into the notes, and do not describe the source code. You need edit access on the board. Notes must be 8,000 characters or fewer. An empty string clears them.

List outbound wake webhooks on a board (board owner only). Secrets and header values are not returned. Add, change, or remove webhooks in the board share sheet.

Return the signed-in Instantboard user.