activity_list
ChatGPTList activity on a board: column moves, assignment changes, and cards created from chat. Use this for what changed. Card tools and overview_get are what is true now. A move includes the column the card left (fromColumnTitle) and the column it landed in (columnTitle) when the source was recorded. Cite boardCardNumber as #N. With since, results are the earliest events in that range. Without since, results are the latest events. truncated is true when more events match than limit.
attachment_delete
ChatGPTRemove a board attachment (edit access). Deletes the file from storage and the board. Pass attachment_id from attachment_list or an upload.
attachment_download
ChatGPTReturn a short-lived download link for one attachment. Board read access is enough: owners, editors, and viewers who can read the board. The url from attachment_list is the app URL. On a private board it needs a browser session and returns 401 to an agent. Call this, then GET download_url with no Cookie and no Authorization (curl or an image viewer). Do not base64 the file into the model. The link lasts 10 minutes, is scoped to this board and attachment, and works for anyone holding it until expires_at. It is not a durable public URL and it is not an app token. If it expires or the signature is rejected, call attachment_download again. A missing or deleted attachment returns not found. Deleting the file makes an existing link fail immediately. Removing board access does not revoke a link already issued; it ends at expires_at.
attachment_list
ChatGPTList board attachments. Pass card_id to filter to one card (#N, id, or prefix). Omit card_id for recent board-wide uploads.
attachment_upload
ChatGPTPrefer attachment_upload_begin → PUT upload_url → attachment_upload_complete. Do not base64 file bytes into the model context — that stalls cloud agents. 1) Call attachment_upload_begin with filename, content_type, size_bytes, and optional card_id. 2) PUT the file bytes to upload_url (curl -X PUT "$upload_url" -H "Content-Type: <content_type>" --data-binary @file). Do not read the file into the prompt. 3) Call attachment_upload_complete with the attachment_id. On a machine with the Instantboard CLI: ib attachment upload <path> [--card <ref>]. file_base64 is capped at 8 KiB for tiny fixtures only; larger files return an error pointing at the PUT flow. Omit file_base64 and pass size_bytes to start a presigned upload (same as attachment_upload_begin).
attachment_upload_begin
ChatGPTStart a board image/video upload (edit access). Do not base64 file bytes into the model context — that stalls cloud agents. 1) Call attachment_upload_begin with filename, content_type, size_bytes, and optional card_id. 2) PUT the file bytes to upload_url (curl -X PUT "$upload_url" -H "Content-Type: <content_type>" --data-binary @file). Do not read the file into the prompt. 3) Call attachment_upload_complete with the attachment_id. On a machine with the Instantboard CLI: ib attachment upload <path> [--card <ref>]. Returns upload_url and attachment_id. Do not pass file bytes or file_path.
attachment_upload_complete
ChatGPTFinish a presigned attachment upload after PUTting the file to upload_url. Do not send file bytes. Pass the attachment_id from attachment_upload_begin.
board_create
ChatGPTCreate a board owned by the signed-in user and return its id and URL. Solo, Founder, or a Founder trial only. Pass columns (name, colour, workflow) or omit them to use Ideas, Doing, and Done.
board_status
ChatGPTSummary counts and metadata for one board.
card_add
ChatGPTAdd a card to a column (by id or column title).
card_archive
ChatGPTArchive a card. Only a card in the rightmost column can be archived. Already-archived cards are rejected.
card_delete
ChatGPTDelete a card by id or unique id prefix.
card_get
ChatGPTGet 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}).
card_list
ChatGPTList 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".
card_search
ChatGPTSearch 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.
card_unarchive
ChatGPTRestore an archived card to the board.
card_update
ChatGPTUpdate 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.
chat_list
ChatGPTList board chat. Without card_id, returns the latest 200 messages (the sidebar). Pass card_id for the full card thread.
chat_post
ChatGPTPost 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.
claim_add
ChatGPTAdd a claim that is not generated from the overview. The claim is marked agent, and agent_name is stored. It gets the next claim number, such as C12. A card link is optional. Leave it unlinked, or use claim_card_create later. Regenerating the overview does not delete or overwrite it.
claim_card_create
ChatGPTCreate a card from a claim and link them. claim_id is the short ref, such as C12. An older id is still accepted. The card goes in Ideas, or the leftmost column when the board has no Ideas column. Title defaults to "Fix: " plus the claim, trimmed to 120 characters. Description includes the claim, the verdict note, the evidence, the source cards, and a link back to the claim. Pass title, description, or column_id to override those.
claim_delete
ChatGPTDelete a claim. claim_id is the short ref, such as C12. An older id is still accepted. Verdicts and card links on that claim are removed. The cards stay. A deleted generated claim is not added again when the overview is regenerated. Pass agent_name. It is stored on the claim.
claim_update
ChatGPTEdit the text of a claim. claim_id is the short ref, such as C12. An older id is still accepted. The edit is kept when every source card is older than the edit. That previous wording is not added as a new claim. When a source card is updated after the edit and regeneration produces different wording, the same claim is updated. It keeps its number, becomes generated again, and is marked Needs recheck. A claim that was added on its own is left as it is. Pass agent_name. It is stored on the claim.
claim_verdict_post
ChatGPTPost one verdict for a claim on the latest overview. claim_id is the short ref, such as C12. An older id is still accepted. verdict is matches, drifted, or unclear. matches and drifted need at least one evidence file. unclear needs a note. note is one or two plain sentences, at most 500 characters. The saved verdict replaces the current one. The old row stays in history. Returns the verdict and the new counts.
claims_check_prompt
ChatGPTThe prompt the Claims tab copies for a coding agent. Use this text. Do not hard-code a different prompt.
claims_list
ChatGPTList the claims on a board. Claims are the checkable sentences saved with the latest overview: what the product does now, grouped by overview section, with the source cards. A claim that nothing has checked has checkStatus "not_checked" and checkLabel "Not checked". This is the same list the Claims tab shows. Pass since as unix milliseconds or an ISO-8601 time to return only claims whose wording or source cards changed after that overview version. document on overview_get is null when there is no overview, and this list is empty until an overview is saved.
column_add
ChatGPTAdd a column to a board.
column_delete
ChatGPTRemove a column (and its cards) from a board.
column_list
ChatGPTList 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.
column_reorder
ChatGPTSet the left-to-right order of every column. Pass each column on this board once, by id or unique title. Column ids, cards, colours, and agent workflows stay with their columns. A repeated id, a missing column, or an id from another board is rejected and nothing moves. If a column was added or removed since the list was read, the call is rejected so the new column is kept. Archiving does not follow this order.
column_update
ChatGPTRename a column or update its view limit, colour, or agent workflow.
get_board
ChatGPTFull board state (columns and cards) for a board you can access.
list_boards
ChatGPTList boards you own or are a member of.
overview_get
ChatGPTRead 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.
overview_update_notes
ChatGPTReplace 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.
webhook_add
ChatGPTAdd an outbound webhook on a board the owner can manage. The webhook is saved switched off and delivers nothing until the owner approves it in Settings. The result includes approvalUrl. Give that link to the user. Do not describe the webhook as active. secret is returned once on create and is not shown again.
webhook_list
ChatGPTList 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.
webhook_remove
ChatGPTRemove an outbound webhook. Takes effect immediately, including one still waiting for approval. Does not call the URL. Board owner only.
webhook_update
ChatGPTChange an outbound webhook the owner can manage. A new URL is saved switched off until the owner approves it again. The result then includes approvalUrl. Give that link to the user. Pausing (enabled false) takes effect immediately. Resuming only works after the owner has approved that URL. This tool cannot approve a webhook.
whoami
ChatGPTReturn the signed-in Instantboard user.