---
{
  "id": "platform.kanban.boards-columns-and-resolution",
  "topic": "kanban",
  "title": "Board, column, and name resolution",
  "locale": "en",
  "version": "2026-07-24",
  "summary": "Board and column names resolve through deterministic defaults, case-insensitive exact matches, then fuzzy substring matches with ambiguity protection.",
  "content": "When both board ID and name are omitted, Kanban chooses the earliest-created board for which the calling Agent has a permission row. With a board name, resolution tries a case-insensitive exact match first, then a case-insensitive substring match. Multiple matches return `ambiguous_resource`; use `list_boards` to obtain an ID or ask the user which board they meant.\n\nWithin the selected board, an omitted column resolves to a column named exactly `To Do` first, otherwise to the lowest `sort_order`. Column names follow the same exact → fuzzy substring → ambiguous sequence. For `list_cards`, `columnName` must be accompanied by `boardId` or `boardName`, because a column name has meaning only inside one board.\n\nAction responses can include resolution metadata with `method: id`, `default`, `exact`, or `fuzzy`, plus the matched resource. Disclose the actual board or column whenever resolution used `default` or `fuzzy`; do not silently present a loose match as exact.\n\n`list_boards` excludes archived boards unless `includeArchived` is true. `list_columns` returns each column’s `column_type` (`normal` or `done`), optional `wip_limit`, sort order, and current non-archived card count. Do not infer internal SQL or escaping behavior beyond these public outcomes.\n",
  "aliases": [
    "default board",
    "default column",
    "board name",
    "column name",
    "fuzzy board match",
    "ambiguous resource",
    "resolution metadata"
  ],
  "tags": [
    "kanban",
    "resolution",
    "board",
    "column"
  ],
  "relatedActions": [
    "arinova.kanban.list_boards",
    "arinova.kanban.list_columns",
    "arinova.kanban.list_cards",
    "arinova.kanban.create_card",
    "arinova.kanban.update_card"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/en/kb/kanban/boards-columns-and-resolution/"
}
---

When both board ID and name are omitted, Kanban chooses the earliest-created board for which the calling Agent has a permission row. With a board name, resolution tries a case-insensitive exact match first, then a case-insensitive substring match. Multiple matches return `ambiguous_resource`; use `list_boards` to obtain an ID or ask the user which board they meant.

Within the selected board, an omitted column resolves to a column named exactly `To Do` first, otherwise to the lowest `sort_order`. Column names follow the same exact → fuzzy substring → ambiguous sequence. For `list_cards`, `columnName` must be accompanied by `boardId` or `boardName`, because a column name has meaning only inside one board.

Action responses can include resolution metadata with `method: id`, `default`, `exact`, or `fuzzy`, plus the matched resource. Disclose the actual board or column whenever resolution used `default` or `fuzzy`; do not silently present a loose match as exact.

`list_boards` excludes archived boards unless `includeArchived` is true. `list_columns` returns each column’s `column_type` (`normal` or `done`), optional `wip_limit`, sort order, and current non-archived card count. Do not infer internal SQL or escaping behavior beyond these public outcomes.