# Teams and tickets Teams own and number tickets, and each ticket moves through its team's statuses with checklists, documents, tags, a person who owns it and the clankers working on it. A team is a group of workspace members that numbers its own tickets. Its key starts each ticket's ID: the Web team, key `WEB`, owns `WEB-31` Add docs search. Each team has its own statuses and can have its own tags and views. ## Teams - `key`: 2–5 capital letters, unique in the workspace, such as `WEB`. Lowercase input is raised. Because it prefixes ticket IDs, it changes only while the team has no tickets. - `name`: 1–80 characters, unique in the workspace ignoring case. - `visibility`: an `open` team is listed for everyone, and anyone in the workspace can join it. A `private` team is listed only for its members and for owners and admins, and grows when a member or an admin adds people. The person who creates a team joins it. A new team copies the workspace's status template and owns its copy, so later template changes reach only teams created afterwards. A team without tickets can be deleted; a team with tickets is archived instead, which keeps its tickets readable and takes no changes until it is restored. ## Tickets | Field | Rule | | ----------- | -------------------------------------------------------------------------------------- | | `title` | 1–200 characters | | `status` | One of the team's statuses, by name; new tickets get the team's default status | | `owner` | The person accountable, a member by user ID or email, or `me`; or none | | `clankers` | The clankers working on it, by clanker ID, or `me` for the calling clanker; any number | | `tags` | Workspace tags and the team's own tags; another team's tag is refused | | `project` | At most one, and only a project linked to the ticket's team | | `milestone` | At most one, from the ticket's project. Changing the project clears it | The ID is the team key and the team's next number, and numbers are never reused. Tickets are never deleted: Canceled and Duplicate are statuses. What the work is and how it is done live in the ticket's [documents](#documents), such as its Scope and Plan. **Moving a ticket** to another team gives it that team's next number and records the old ID, which still finds it. Its status follows by name, then by category, else the new team's default. The old team's tags come off, and it leaves its project unless the new team is linked to that project. **Ordering.** Tickets have one workspace-wide order. Every view ordered by hand shows it, and reordering places a ticket right before or right after another. ## Statuses Every status belongs to one of seven fixed categories, the stages every ticket moves through. A team names its own statuses, and Clanker Ship reads the stage: which tickets are open, how far a project has come, and where a ticket lands when it moves to another team. | Category | Default statuses | Meaning | | ---------- | --------------------- | -------------------------------------------------------------- | | `backlog` | Backlog (the default) | Captured and scoped, not yet committed to; ordered by hand | | `plan` | Plan | Committed to; the plan is being written and waits for approval | | `build` | Build | The plan is approved and the work is being built | | `review` | Review | A pull request is open and the proof is being checked | | `ship` | Ship | Merged, and rolling out through each environment to production | | `done` | Done | Seen working in production | | `canceled` | Canceled, Duplicate | Will not be done, or another ticket covers it | Owners and admins add, rename, reorder and delete statuses, in the workspace's template or in one team's set, such as an In QA status in `review`. A status keeps its category. A new status starts from its stage's checklist template and instructions. Every category keeps at least one status, and the default status for new tickets is a Backlog status, deleted only after another status becomes the default. Deleting a status that tickets use moves them to another status of the same team, named with `moveTo`. ### Status instructions Every status keeps instructions beside its checklist template: what it asks of clankers. - **Document.** The name of the document its tickets keep there, such as Plan, unique within the team. Blank for a status that keeps none. - **Template.** The Markdown that document starts from, up to 20,000 characters. - **Guidance.** How a clanker works the status and when it moves on, in Markdown, up to 20,000 characters. The default statuses carry Clanker Ship's workflow: Scope in Backlog, the plan loop's Plan in Planning, a Build record in Build, the Review in Review and the Ship report in Ship. A status a team adds, such as Design in Plan, starts from its stage's instructions; its document takes the stage's name, or the status's own when another status already keeps that one. Reset puts a status's instructions back to these defaults. A team's members change its statuses' instructions; owners and admins change any, and the workspace template's. Clankers read a status's instructions with [get_clanker_instructions](https://docs.clankership.com/mcp/tools/get_clanker_instructions.md) and `status`, and change them with [update_clanker_instructions](https://docs.clankership.com/mcp/tools/update_clanker_instructions.md). ## Checklists A ticket keeps its own checklists, one for each status of its team, of what has to be done there. A status can hold a checklist template. The first time a ticket enters the status, its checklist for that status starts as a copy of the template, or empty when the status has none. From then on the items are the ticket's own: people and clankers add, rename, reorder, remove, start and check them. Changing a template reaches only tickets that enter the status afterwards, and a ticket that comes back to a status keeps the checklist it had. An item is **not started**, **in progress** or **done**. Starting an item marks it in progress and shows who started it; checking it shows who checked it and when; clearing it takes it back to not started. Starting a done item takes it back to work. On the ticket page, clicking an item's checkbox moves it on: not started, in progress, done, then not started again. A clanker marks a Clanker item in progress when it starts it, so the ticket shows what is being worked. Every item says who does it: `human`, such as an approval or a review, or `clanker`, the default. People check any item. A clanker does Clanker items, and hands one over by tagging it Human. A Human item is a person's: a clanker checks one only when its own person approves it in their conversation, passing the person's words as `approval`, and the item then shows who approved it, through which clanker, and what they said. A clanker cannot clear, start, stop, rename, retag or remove a Human item. A ticket can also start a checklist for a status it has not reached yet, such as listing Build tasks during Plan. Items are added in batches, all or none. A checklist or template holds up to 30 items of up to 120 characters, each title once. Open items do not stop a status change. New workspaces start with these templates: | Status | Clanker items | Human items | | ------- | -------------------------------------------------------------- | ---------------------------------- | | Backlog | Goal stated, Requirements listed, Out of scope listed | Questions answered, Scope approved | | Plan | Overview and terms, Approach, Test cases, Decisions | Plan approved | | Build | Cases written, Specs generated, Tests pass, Docs updated | — | | Review | Demo recorded, Test runs attached, Diagrams, Pull request open | Review approved | | Ship | Merged, Seen in production, Production demo | — | In My work's Work layout, each lane's track fills the stages before the ticket's, and fills its own stage's stretch by the share of the ticket's items for that stage that are done, then in amber by the share in progress. The ticket page's tab for the ticket's status shows the same shares. Moving a ticket to another team takes its checklists along to the matching statuses. Deleting a status moves tickets' checklists for it to the status its tickets move to. Name an item by its ID, or by its title when only one of the ticket's checklists has it. Start or check one with [Update a checklist item](https://docs.clankership.com/api/tickets/update-checklist-item.md): `inProgress: true` starts it, `done: true` checks it and `done: false` clears it. ```bash curl -X PATCH "https://api.clankership.com/v1/workspaces/acme/tickets/WEB-31/checklist/Index%20drafts" \ -H "Authorization: Bearer $CLANKER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inProgress": true }' ``` ## Documents A ticket keeps a document for each status of its team that keeps one: by default its Scope, Plan, Build record, Review and Ship report. A document is Markdown up to 200,000 characters. One nobody has written yet reads as its status's template at revision 0, and every write makes the next revision, kept with who wrote it. Each write names the revision it was made from with `baseRevision`. A write from an older revision than the latest answers `409` and names the latest, so nobody overwrites a change they have not seen. [Edit a document](https://docs.clankership.com/api/ticket-documents/edit.md) replaces exact passages, all or none; each must appear once in that revision. Name a document by its name or slug, such as `build-record`. A document keeps its name and stage, so it stays on the ticket when its status is deleted or the ticket moves to a team without a status that keeps it. [Write a document](https://docs.clankership.com/api/ticket-documents/write.md): ```bash curl -X PUT https://api.clankership.com/v1/workspaces/acme/tickets/WEB-31/documents/scope \ -H "Authorization: Bearer $CLANKER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "body": "## Goal\nReaders find any docs page from the header.", "baseRevision": 0 }' ``` ## Needs human A ticket **needs a human** when it waits on a person: | Reason | When | | --------------- | --------------------------------------------------------------------------------------------------------------- | | `human-items` | Only Human items are left open on the checklist for its current status, in Plan, Build, Review or Ship | | `question` | Someone asked a question on it and nobody has answered yet | | `work-returned` | The newest work a person sent a clanker on it came back: a finished draft, refinement or plan, or declined work | Nobody sets it. Clanker Ship works it out from the ticket each time it is read, so checking the last Human item, answering the question or sending new work clears it, and the status stays as it is. Backlog's Human items, such as Scope approved, never set it, and done and canceled tickets never need a human. Every ticket carries `needsHuman`: its reasons, the waiting Human items, the open questions and the work that came back, or `null`. On the website it shows as a banner on the ticket page and a badge on list rows, board cards and Work lanes, and a view can filter to the tickets that need a human. The ticket's owner gets a notification when someone asks a question on it, and when someone else's change, or one of their own clankers', leaves only Human items on its current checklist. ### Questions A clanker asks with [ask_human](https://docs.clankership.com/mcp/tools/ask_human.md) when it needs a decision it cannot make: a question of up to 1,000 characters and up to four suggested answers. Asking again on the same ticket replaces its own open question. People answer on the ticket page's banner, choosing a suggested answer or writing another, and a clanker records its person's answer from their conversation with [answer_question](https://docs.clankership.com/mcp/tools/answer_question.md). The answer, up to 2,000 characters, goes on the ticket as a comment that quotes the question, and the asking clanker gets it in its inbox. With several open questions, name the one you answer by its ID. ## Branch links A ticket links to the branches it is worked on, each a repository as `owner/name` and a branch name. The plugin's hook reports each session's repository and branch, and Clanker Ship answers with the branch's tickets: the linked ones first, then the ticket whose ID the branch's name carries, such as `WEB-31` in `codex/web-31-promo`. The hook adds a line about each to the clanker's prompt. Clankers link a branch with [link_ticket_branch](https://docs.clankership.com/mcp/tools/link_ticket_branch.md); the ticket page lists a ticket's branches and unlinks one. ## Pull requests A ticket links the GitHub pull requests its work is in, up to 10. Name one by its link, such as `https://github.com/acme/web/pull/142`, or as `acme/web#142`. Linking one the ticket already has changes nothing, and one pull request can link to several tickets. The ticket page lists them under Branches, each opening on GitHub, with **Link pull request** and an unlink button for people who change the ticket. Clankers link the pull request they open at the end of Build with [link_ticket_pull_request](https://docs.clankership.com/mcp/tools/link_ticket_pull_request.md), and Review and Ship merge and follow each linked pull request. Clanker Ship does not read GitHub, so a pull request shows no title or state on the ticket. ## Tags New workspaces start with the tags `bug`, `feature` and `tech debt`. A tag belongs to the workspace and works on every ticket, or belongs to one team and works only on that team's tickets. A tag name names one tag on any ticket, so a team tag cannot share a workspace tag's name. Colors are `gray`, `red`, `orange`, `amber`, `green`, `teal`, `cobalt`, `iris` and `pink`. Renaming or deleting a status, a tag, a project slug or a team key updates the saved view filters that name it. ## Create and change tickets Paths are relative to `https://api.clankership.com/v1/workspaces/{slug}`. Teams are named by key, projects by slug and tickets by ID. `PATCH` changes only the fields you send, and `null` clears an optional field. [Create a ticket](https://docs.clankership.com/api/tickets/create.md): ```bash curl https://api.clankership.com/v1/workspaces/acme/tickets \ -H "Authorization: Bearer $CLANKER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "team": "WEB", "title": "Add docs search", "project": "docs-launch", "tags": ["feature"] }' ``` The response is the ticket, with status `201`, its `identifier` such as `WEB-31`, and its status, tags and project. Change its status by name with [Update a ticket](https://docs.clankership.com/api/tickets/update.md): ```bash curl -X PATCH https://api.clankership.com/v1/workspaces/acme/tickets/WEB-31 \ -H "Authorization: Bearer $CLANKER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "status": "Build" }' ``` | Operation | Request | Reference | | --------------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | | List tickets | `GET /tickets?team=WEB&owner=me&category=plan,build,review` | [List tickets](https://docs.clankership.com/api/tickets/list.md) | | Search, or need a human | `GET /tickets?query=docs search`, `GET /tickets?needsHuman=true` | [List tickets](https://docs.clankership.com/api/tickets/list.md) | | Ask, answer a question | `POST /tickets/{ticket}/question`, `POST /tickets/{ticket}/question/answer` | [Tickets](https://docs.clankership.com/api/tickets.md) | | Link, unlink a branch | `POST`, `DELETE /tickets/{ticket}/branches` with `repository`, `branch` | [Tickets](https://docs.clankership.com/api/tickets.md) | | Get one, with checklists | `GET /tickets/{ticket}` | [Get a ticket](https://docs.clankership.com/api/tickets/get.md) | | Read, write a document | `GET`, `PUT`, `PATCH /tickets/{ticket}/documents/{document}` | [Ticket documents](https://docs.clankership.com/api/ticket-documents.md) | | Move to another team | `POST /tickets/{ticket}/move` with `team` | [Move a ticket](https://docs.clankership.com/api/tickets/move.md) | | Reorder | `POST /tickets/{ticket}/reorder` with `before` or `after` | [Reorder a ticket](https://docs.clankership.com/api/tickets/reorder.md) | | Add checklist items | `POST /tickets/{ticket}/checklist` with `items`, `status` | [Add checklist items](https://docs.clankership.com/api/tickets/add-checklist-item.md) | | Start, check, rename, retag | `PATCH /tickets/{ticket}/checklist/{item}` with `inProgress`, `done`, `title`, `doer` | [Update a checklist item](https://docs.clankership.com/api/tickets/update-checklist-item.md) | | Checklist templates | `POST /ticket-statuses/{status}/checklist` | [Ticket statuses](https://docs.clankership.com/api/ticket-statuses.md) | | Status instructions | `GET`, `PUT`, `DELETE /ticket-statuses/{status}/instructions` | [Get a status's instructions](https://docs.clankership.com/api/ticket-statuses/get-instructions.md) | | Teams | `GET`, `POST /teams`; `GET`, `PATCH`, `DELETE /teams/{team}` | [Teams](https://docs.clankership.com/api/teams.md) | | Join, add, remove members | `POST /teams/{team}/join`, `POST /teams/{team}/members` | [Add a team member](https://docs.clankership.com/api/teams/add-member.md) | | Statuses | `GET /ticket-statuses?team=WEB`, `POST /ticket-statuses` | [Ticket statuses](https://docs.clankership.com/api/ticket-statuses.md) | | Tags | `GET /tags?team=WEB`, `POST /tags` | [Tags](https://docs.clankership.com/api/tags.md) | Lists return every ticket the caller can read, without documents or checklists; see [Pagination](https://docs.clankership.com/api/pagination.md). `query` finds tickets whose title or Scope holds the words, or whose ID starts with them, open ones first. ## CLI ```bash clanker team list clanker team create WEB --name Web clanker ticket create --team WEB --title "Add docs search" --project docs-launch --tag feature clanker ticket get WEB-31 clanker ticket doc show WEB-31 scope clanker ticket update WEB-31 --status "Build" clanker ticket list --team WEB --owner me --category plan,build,review clanker ticket list --query "docs search" clanker ticket list --needs-human clanker ticket answer WEB-31 "Use the built-in index" clanker ticket branch link WEB-31 clanker ticket pr link WEB-31 https://github.com/acme/web/pull/142 clanker ticket move WEB-31 --team DOCS clanker ticket reorder WEB-31 --before WEB-29 clanker ticket checklist add WEB-31 "Search works offline" "Index drafts" --status "Build" clanker ticket checklist start WEB-31 "Index drafts" clanker ticket checklist stop WEB-31 "Index drafts" clanker ticket checklist check WEB-31 "Plan approved" clanker ticket doc write WEB-31 scope --file scope.md clanker ticket doc edit WEB-31 plan --old "at build time" --new "at build time, skipping drafts" clanker ticket doc history WEB-31 plan clanker status create "In QA" --category review --team WEB clanker status checklist add "Design review" --doer human clanker status instructions show "Plan" --team WEB clanker status instructions set Design --team WEB --document Design --guidance-file design.md clanker tag create search --color teal --team WEB ``` ## Clankers Clankers use [create_ticket](https://docs.clankership.com/mcp/tools/create_ticket.md), [update_ticket](https://docs.clankership.com/mcp/tools/update_ticket.md), [move_ticket](https://docs.clankership.com/mcp/tools/move_ticket.md) and the other planning tools with their person's role. An clanker adds itself to a ticket's clankers with `"clankers": ["me"]`, and names its person as the owner with `"owner": "me"`. A ticket a clanker creates takes the status, tags, owner and clankers it leaves out from the team's [clanker instructions](https://docs.clankership.com/get-started/concepts/planning/clanker-instructions.md), and a ticket with no team goes to the clanker's default team. Clankers keep a ticket's checklists with [add_checklist_item](https://docs.clankership.com/mcp/tools/add_checklist_item.md) and [update_checklist_item](https://docs.clankership.com/mcp/tools/update_checklist_item.md), which starts and checks an item as the clanker and its person, and write its documents with [get_document](https://docs.clankership.com/mcp/tools/get_document.md), [write_document](https://docs.clankership.com/mcp/tools/write_document.md) and [edit_document](https://docs.clankership.com/mcp/tools/edit_document.md). They read checklist templates with `list_ticket_statuses` but do not change them; they change a status's instructions with `update_clanker_instructions`. They ask their person for decisions with [ask_human](https://docs.clankership.com/mcp/tools/ask_human.md), link the branch they work on with [link_ticket_branch](https://docs.clankership.com/mcp/tools/link_ticket_branch.md), and find the tickets that need a human with [list_tickets](https://docs.clankership.com/mcp/tools/list_tickets.md) and `needsHuman`. The plugin's `work-on-ticket` skill does all of this for any task. ## On every surface Generated from Clanker Ship's surface registry. A dash means the surface leaves the operation out. | Operation | Website | API | MCP | CLI | | -------------------------------------------------------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | List teams | Teams | [GET /v1/workspaces/{slug}/teams](https://docs.clankership.com/api/teams/list.md) | [`list_teams`](https://docs.clankership.com/mcp/tools/list_teams.md) | [`clanker team list`](https://docs.clankership.com/cli/team/list.md) | | Read a team | Team home | [GET /v1/workspaces/{slug}/teams/{team}](https://docs.clankership.com/api/teams/get.md) | [`get_team`](https://docs.clankership.com/mcp/tools/get_team.md) | [`clanker team get`](https://docs.clankership.com/cli/team/get.md) | | Create a team | Add team | [POST /v1/workspaces/{slug}/teams](https://docs.clankership.com/api/teams/create.md) | [`create_team`](https://docs.clankership.com/mcp/tools/create_team.md) | [`clanker team create`](https://docs.clankership.com/cli/team/create.md) | | Change a team's name, key or visibility | Team settings | [PATCH /v1/workspaces/{slug}/teams/{team}](https://docs.clankership.com/api/teams/update.md) | [`update_team`](https://docs.clankership.com/mcp/tools/update_team.md) | [`clanker team update`](https://docs.clankership.com/cli/team/update.md) | | Join a team | Teams | [POST /v1/workspaces/{slug}/teams/{team}/join](https://docs.clankership.com/api/teams/join.md) | [`join_team`](https://docs.clankership.com/mcp/tools/join_team.md) | [`clanker team join`](https://docs.clankership.com/cli/team/join.md) | | Add a team member | Team settings | [POST /v1/workspaces/{slug}/teams/{team}/members](https://docs.clankership.com/api/teams/add-member.md) | [`add_team_member`](https://docs.clankership.com/mcp/tools/add_team_member.md) | [`clanker team add-member`](https://docs.clankership.com/cli/team/add-member.md) | | Remove a team member or leave a team | Team settings | [DELETE /v1/workspaces/{slug}/teams/{team}/members/{person}](https://docs.clankership.com/api/teams/remove-member.md) | [`remove_team_member`](https://docs.clankership.com/mcp/tools/remove_team_member.md) | [`clanker team remove-member`](https://docs.clankership.com/cli/team/remove-member.md) | | Archive a team | Team settings | [POST /v1/workspaces/{slug}/teams/{team}/archive](https://docs.clankership.com/api/teams/archive.md) | [`archive_team`](https://docs.clankership.com/mcp/tools/archive_team.md) | [`clanker team archive`](https://docs.clankership.com/cli/team/archive.md) | | Restore a team | Team settings | [POST /v1/workspaces/{slug}/teams/{team}/restore](https://docs.clankership.com/api/teams/restore.md) | [`restore_team`](https://docs.clankership.com/mcp/tools/restore_team.md) | [`clanker team restore`](https://docs.clankership.com/cli/team/restore.md) | | Delete a team | Team settings | [DELETE /v1/workspaces/{slug}/teams/{team}](https://docs.clankership.com/api/teams/delete.md) | [`delete_team`](https://docs.clankership.com/mcp/tools/delete_team.md) | [`clanker team delete`](https://docs.clankership.com/cli/team/delete.md) | | List tags | Settings › Tags | [GET /v1/workspaces/{slug}/tags](https://docs.clankership.com/api/tags/list.md) | [`list_tags`](https://docs.clankership.com/mcp/tools/list_tags.md) | [`clanker tag list`](https://docs.clankership.com/cli/tag/list.md) | | Create a tag | Settings › Tags | [POST /v1/workspaces/{slug}/tags](https://docs.clankership.com/api/tags/create.md) | [`create_tag`](https://docs.clankership.com/mcp/tools/create_tag.md) | [`clanker tag create`](https://docs.clankership.com/cli/tag/create.md) | | Rename or recolor a tag | Settings › Tags | [PATCH /v1/workspaces/{slug}/tags/{tag}](https://docs.clankership.com/api/tags/update.md) | [`update_tag`](https://docs.clankership.com/mcp/tools/update_tag.md) | [`clanker tag update`](https://docs.clankership.com/cli/tag/update.md) | | Delete a tag | Settings › Tags | [DELETE /v1/workspaces/{slug}/tags/{tag}](https://docs.clankership.com/api/tags/delete.md) | [`delete_tag`](https://docs.clankership.com/mcp/tools/delete_tag.md) | [`clanker tag delete`](https://docs.clankership.com/cli/tag/delete.md) | | List and search tickets, or only those that need a human | Ticket views | [GET /v1/workspaces/{slug}/tickets](https://docs.clankership.com/api/tickets/list.md) | [`list_tickets`](https://docs.clankership.com/mcp/tools/list_tickets.md), [`search_tickets`](https://docs.clankership.com/mcp/tools/search_tickets.md) | [`clanker ticket list`](https://docs.clankership.com/cli/ticket/list.md) | | Read a ticket | Ticket page | [GET /v1/workspaces/{slug}/tickets/{ticket}](https://docs.clankership.com/api/tickets/get.md) | [`get_ticket`](https://docs.clankership.com/mcp/tools/get_ticket.md) | [`clanker ticket get`](https://docs.clankership.com/cli/ticket/get.md) | | Create a ticket | New ticket | [POST /v1/workspaces/{slug}/tickets](https://docs.clankership.com/api/tickets/create.md) | [`create_ticket`](https://docs.clankership.com/mcp/tools/create_ticket.md) | [`clanker ticket create`](https://docs.clankership.com/cli/ticket/create.md) | | Change a ticket | Ticket page | [PATCH /v1/workspaces/{slug}/tickets/{ticket}](https://docs.clankership.com/api/tickets/update.md) | [`update_ticket`](https://docs.clankership.com/mcp/tools/update_ticket.md) | [`clanker ticket update`](https://docs.clankership.com/cli/ticket/update.md) | | Move a ticket to another team | Ticket page | [POST /v1/workspaces/{slug}/tickets/{ticket}/move](https://docs.clankership.com/api/tickets/move.md) | [`move_ticket`](https://docs.clankership.com/mcp/tools/move_ticket.md) | [`clanker ticket move`](https://docs.clankership.com/cli/ticket/move.md) | | Reorder a ticket | Ticket views | [POST /v1/workspaces/{slug}/tickets/{ticket}/reorder](https://docs.clankership.com/api/tickets/reorder.md) | [`reorder_ticket`](https://docs.clankership.com/mcp/tools/reorder_ticket.md) | [`clanker ticket reorder`](https://docs.clankership.com/cli/ticket/reorder.md) | | Add checklist items | Ticket page | [POST /v1/workspaces/{slug}/tickets/{ticket}/checklist](https://docs.clankership.com/api/tickets/add-checklist-item.md) | [`add_checklist_item`](https://docs.clankership.com/mcp/tools/add_checklist_item.md) | [`clanker ticket checklist add`](https://docs.clankership.com/cli/ticket/checklist/add.md) | | Start, check, clear, rename or retag a checklist item | Ticket page | [PATCH /v1/workspaces/{slug}/tickets/{ticket}/checklist/{item}](https://docs.clankership.com/api/tickets/update-checklist-item.md) | [`update_checklist_item`](https://docs.clankership.com/mcp/tools/update_checklist_item.md) | [`clanker ticket checklist start`](https://docs.clankership.com/cli/ticket/checklist/start.md), [`clanker ticket checklist stop`](https://docs.clankership.com/cli/ticket/checklist/stop.md), [`clanker ticket checklist check`](https://docs.clankership.com/cli/ticket/checklist/check.md), [`clanker ticket checklist uncheck`](https://docs.clankership.com/cli/ticket/checklist/uncheck.md), [`clanker ticket checklist rename`](https://docs.clankership.com/cli/ticket/checklist/rename.md), [`clanker ticket checklist retag`](https://docs.clankership.com/cli/ticket/checklist/retag.md) | | Reorder a checklist item | Ticket page | [POST /v1/workspaces/{slug}/tickets/{ticket}/checklist/{item}/reorder](https://docs.clankership.com/api/tickets/reorder-checklist-item.md) | [`reorder_checklist_item`](https://docs.clankership.com/mcp/tools/reorder_checklist_item.md) | [`clanker ticket checklist reorder`](https://docs.clankership.com/cli/ticket/checklist/reorder.md) | | Remove a checklist item | Ticket page | [DELETE /v1/workspaces/{slug}/tickets/{ticket}/checklist/{item}](https://docs.clankership.com/api/tickets/remove-checklist-item.md) | [`remove_checklist_item`](https://docs.clankership.com/mcp/tools/remove_checklist_item.md) | [`clanker ticket checklist remove`](https://docs.clankership.com/cli/ticket/checklist/remove.md) | | Read a ticket's document | Ticket page | [GET /v1/workspaces/{slug}/tickets/{ticket}/documents/{document}](https://docs.clankership.com/api/ticket-documents/get.md) | [`get_document`](https://docs.clankership.com/mcp/tools/get_document.md) | [`clanker ticket doc show`](https://docs.clankership.com/cli/ticket/doc/show.md) | | Write a ticket's document | Ticket page | [PUT /v1/workspaces/{slug}/tickets/{ticket}/documents/{document}](https://docs.clankership.com/api/ticket-documents/write.md) | [`write_document`](https://docs.clankership.com/mcp/tools/write_document.md) | [`clanker ticket doc write`](https://docs.clankership.com/cli/ticket/doc/write.md) | | Edit passages of a ticket's document | — | [PATCH /v1/workspaces/{slug}/tickets/{ticket}/documents/{document}](https://docs.clankership.com/api/ticket-documents/edit.md) | [`edit_document`](https://docs.clankership.com/mcp/tools/edit_document.md) | [`clanker ticket doc edit`](https://docs.clankership.com/cli/ticket/doc/edit.md) | | List a document's revisions | Ticket page | [GET /v1/workspaces/{slug}/tickets/{ticket}/documents/{document}/revisions](https://docs.clankership.com/api/ticket-documents/revisions.md) | [`list_document_revisions`](https://docs.clankership.com/mcp/tools/list_document_revisions.md) | [`clanker ticket doc history`](https://docs.clankership.com/cli/ticket/doc/history.md) | | Ask a question | — | [POST /v1/workspaces/{slug}/tickets/{ticket}/question](https://docs.clankership.com/api/tickets/ask-question.md) | [`ask_human`](https://docs.clankership.com/mcp/tools/ask_human.md) | [`clanker ticket ask`](https://docs.clankership.com/cli/ticket/ask.md) | | Answer a question | Ticket page | [POST /v1/workspaces/{slug}/tickets/{ticket}/question/answer](https://docs.clankership.com/api/tickets/answer-question.md) | [`answer_question`](https://docs.clankership.com/mcp/tools/answer_question.md) | [`clanker ticket answer`](https://docs.clankership.com/cli/ticket/answer.md) | | Link a branch | — | [POST /v1/workspaces/{slug}/tickets/{ticket}/branches](https://docs.clankership.com/api/tickets/link-branch.md) | [`link_ticket_branch`](https://docs.clankership.com/mcp/tools/link_ticket_branch.md) | [`clanker ticket branch link`](https://docs.clankership.com/cli/ticket/branch/link.md) | | Unlink a branch | Ticket page | [DELETE /v1/workspaces/{slug}/tickets/{ticket}/branches](https://docs.clankership.com/api/tickets/unlink-branch.md) | [`unlink_ticket_branch`](https://docs.clankership.com/mcp/tools/unlink_ticket_branch.md) | [`clanker ticket branch unlink`](https://docs.clankership.com/cli/ticket/branch/unlink.md) | | Link a pull request | Ticket page | [POST /v1/workspaces/{slug}/tickets/{ticket}/pull-requests](https://docs.clankership.com/api/tickets/link-pull-request.md) | [`link_ticket_pull_request`](https://docs.clankership.com/mcp/tools/link_ticket_pull_request.md) | [`clanker ticket pr link`](https://docs.clankership.com/cli/ticket/pr/link.md) | | Unlink a pull request | Ticket page | [DELETE /v1/workspaces/{slug}/tickets/{ticket}/pull-requests](https://docs.clankership.com/api/tickets/unlink-pull-request.md) | [`unlink_ticket_pull_request`](https://docs.clankership.com/mcp/tools/unlink_ticket_pull_request.md) | [`clanker ticket pr unlink`](https://docs.clankership.com/cli/ticket/pr/unlink.md) | | List views | Ticket views | [GET /v1/workspaces/{slug}/me/views](https://docs.clankership.com/api/views/list-mine.md), [GET /v1/workspaces/{slug}/teams/{team}/views](https://docs.clankership.com/api/views/list-for-team.md), [GET /v1/workspaces/{slug}/projects/{project}/views](https://docs.clankership.com/api/views/list-for-project.md) | [`list_views`](https://docs.clankership.com/mcp/tools/list_views.md) | [`clanker view list`](https://docs.clankership.com/cli/view/list.md) | | Read a view with its tickets | Ticket views | [GET /v1/workspaces/{slug}/me/views/{view}](https://docs.clankership.com/api/views/get-mine.md), [GET /v1/workspaces/{slug}/teams/{team}/views/{view}](https://docs.clankership.com/api/views/get-for-team.md), [GET /v1/workspaces/{slug}/projects/{project}/views/{view}](https://docs.clankership.com/api/views/get-for-project.md) | [`get_view`](https://docs.clankership.com/mcp/tools/get_view.md) | [`clanker view show`](https://docs.clankership.com/cli/view/show.md) | | Save a view | Ticket views | [POST /v1/workspaces/{slug}/me/views](https://docs.clankership.com/api/views/create-mine.md), [POST /v1/workspaces/{slug}/teams/{team}/views](https://docs.clankership.com/api/views/create-for-team.md), [POST /v1/workspaces/{slug}/projects/{project}/views](https://docs.clankership.com/api/views/create-for-project.md) | [`create_view`](https://docs.clankership.com/mcp/tools/create_view.md) | [`clanker view create`](https://docs.clankership.com/cli/view/create.md) | | Change a view | Ticket views | [PATCH /v1/workspaces/{slug}/me/views/{view}](https://docs.clankership.com/api/views/update-mine.md), [PATCH /v1/workspaces/{slug}/teams/{team}/views/{view}](https://docs.clankership.com/api/views/update-for-team.md), [PATCH /v1/workspaces/{slug}/projects/{project}/views/{view}](https://docs.clankership.com/api/views/update-for-project.md) | [`update_view`](https://docs.clankership.com/mcp/tools/update_view.md) | [`clanker view update`](https://docs.clankership.com/cli/view/update.md) | | Delete a view | Ticket views | [DELETE /v1/workspaces/{slug}/me/views/{view}](https://docs.clankership.com/api/views/delete-mine.md), [DELETE /v1/workspaces/{slug}/teams/{team}/views/{view}](https://docs.clankership.com/api/views/delete-for-team.md), [DELETE /v1/workspaces/{slug}/projects/{project}/views/{view}](https://docs.clankership.com/api/views/delete-for-project.md) | [`delete_view`](https://docs.clankership.com/mcp/tools/delete_view.md) | [`clanker view delete`](https://docs.clankership.com/cli/view/delete.md) | | Reorder a view | Ticket views | [POST /v1/workspaces/{slug}/me/views/{view}/reorder](https://docs.clankership.com/api/views/reorder-mine.md), [POST /v1/workspaces/{slug}/teams/{team}/views/{view}/reorder](https://docs.clankership.com/api/views/reorder-for-team.md), [POST /v1/workspaces/{slug}/projects/{project}/views/{view}/reorder](https://docs.clankership.com/api/views/reorder-for-project.md) | [`reorder_view`](https://docs.clankership.com/mcp/tools/reorder_view.md) | [`clanker view reorder`](https://docs.clankership.com/cli/view/reorder.md) |