{"name":"TechTools Kanban API","version":"4.1","updated":"2026-09-30","description":"Multi-tenant Kanban boards: companies and members, boards with configurable columns and WIP limits, tickets with hierarchy, labels, links, watchers, comments with @mentions, attachments, a change timeline, notifications, reports and CSV/JSON export. Every company configures which fields and features exist (preferences) and which workflow rules the API enforces.","base_url":"https://techtools.cz/kanban-api","tool":"https://techtools.cz/tools/kanban/","authentication":{"session":"Shared TechTools account. POST /shared-auth-api/login and send the _techtools_session cookie (credentials: \"include\" from a browser, -c/-b cookie jar from curl). Every endpoint below needs it except /docs and the public share snapshot.","tenancy":"Every record belongs to exactly one company. An id of a company the signed-in account is not a member of answers 404 NOT_FOUND, exactly like an id that does not exist, whatever the endpoint. A deleted board and everything on it answers 404 too.","roles":"owner / admin / member. Board structure (columns, board rename or delete, share links) is owner+admin only; everything else is open to members."},"conventions":{"ids":"Numeric. Tickets also carry a human key, e.g. \"PAL-42\" (board key + number).","status":["backlog","analysis","development","testing","ready","done"],"ageing":"Every ticket carries days_in_column and stale? — how long it has sat where it is (stale = 7+ days in a working column). column_entered_at is stamped on every move.","priority_scale":"p1..p4 only. The legacy names (critical/high/medium/low) are still accepted and normalized on write.","ticket_types":["incident","story","task","bug","risk","epic","initiative"],"priorities":["p1","p2","p3","p4","low","medium","high","critical"],"link_types":["blocks","relates","duplicates"],"polling":"GET …/tickets sends an ETag. Repeat the request with If-None-Match to get 304 Not Modified while the board is unchanged.","preferences":"Each company carries a normalized preferences hash (see /companies/:id/settings). The `rules` group is enforced server-side: a refused write answers 422 with { error, code: \"RULE_BLOCKED\", rule: \"\u003cwhich rule\u003e\" }.","search_query":"The search endpoint takes a small operator language: bare words are AND-ed full text; key:PAL-42, assignee:me, reporter:, type:, priority:, status:, label:, board:, is:archived|open|overdue|blocked|mine|unassigned|watching, in:comments. Quote values with spaces: label:\"needs design\". Matching ignores case and diacritics in any language (\"zadost\" finds \"Žádost\"); % and _ are plain characters. GET /boards/:id/tickets?search= matches the same way."},"endpoints":{"companies":{"GET /companies":"companies the caller belongs to","POST /companies":"{ company: { name } }","GET /companies/:id/members":"members with id, username (the @mention handle), name, role","GET /companies/:id/settings":"company preferences + the declarative schema, defaults and presets (any member)","PATCH /companies/:id/settings":"{ settings: { fields: {…}, cards: {…}, board: {…}, rules: {…}, defaults: {…}, terms: {…}, display: {…} } } or { preset: \"minimal\"|\"standard\"|\"full\" } (owner, admin). Unknown keys are dropped","GET|POST /companies/:id/invitations, DELETE /companies/:id/invitations/:id":"list, create and delete invitations (owner, admin). { invitation: { invitation_type: \"email\", email } | { invitation_type: \"link\"|\"code\", max_uses } }. TechTools sends no invitation e-mail: an email invitation answers with invitation_url, the personal link to pass on. Nobody is added to a company directly (POST /companies/:id/members answers 403 INVITATION_REQUIRED)"},"invitations":{"POST /invitations/join-link":"{ token }: redeem a link invitation or an email invitation's personal link","POST /invitations/join":"{ code }: redeem a code invitation","GET /invitations":"email invitations waiting for the caller. Listed only when the account holds the invited @techtools.cz address (the one kind of address TechTools verifies); everyone else joins through the personal link","POST /invitations/:id/accept, POST /invitations/:id/decline":"an email invitation, by its invitee only: the holder of the invited @techtools.cz address, or a caller sending { token }. Anything else answers 404"},"boards":{"GET /boards?company_id=":"boards of a company, with their columns","POST /companies/:company_id/boards":"{ board: { name, key } } — key is 2-5 uppercase letters; six default columns are created","PATCH /boards/:id":"rename / describe (owner, admin)","DELETE /boards/:id":"deactivate (owner, admin)","GET /boards/:id/reports":"cycle time (avg/median/p85), throughput and created counts per week, WIP per column, totals by status/assignee/type","GET /boards/:id/export":"CSV of every ticket; ?format=json for JSON","POST /boards/:id/archive-done?older_than_days=":"bulk-archive finished work (owner, admin, member)","GET|POST /boards/:id/views, DELETE /boards/:id/views/:view_id":"saved filter + swimlane combinations, per user","GET /boards/:id/share, POST, DELETE":"public read-only share link (owner, admin)","GET /shared/:token":"the public snapshot — no session, the token is the credential"},"columns":{"GET /boards/:board_id/columns":"columns with ticket_count and at_wip_limit","POST /boards/:board_id/columns":"{ column: { name, color, wip_limit, status_key } } (owner, admin)","PATCH /columns/:id":"rename, recolor, set wip_limit or status_key (owner, admin). A column never changes board","PATCH /columns/:id/reorder":"{ position } (owner, admin)","DELETE /columns/:id":"tickets are MOVED to ?move_to_column_id= (or the nearest column), never deleted; the last column cannot be removed"},"tickets":{"GET /boards/:board_id/tickets":"active tickets; ?archived=1 for the archive, ?archived=all for both. Sends an ETag","POST /boards/:board_id/tickets":"{ ticket: { column_id, title, … }, label_ids: [] } (the column decides the board)","GET /tickets/:id":"full ticket incl. parent, labels, comments","PATCH /tickets/:id":"any writable field: title, description, ticket_type, priority, assignee_id, dev_assignee_id, qa_assignee_id, reporter_id, due_date, story points, acceptance_criteria, technical_notes, parent_id, column_id; label_ids: [] beside the ticket hash. A ticket stays on its board: board_id is not writable, column_id and parent_id must be on the same board, label_ids of other boards are ignored, and every person must be a member of the company (422 otherwise)","PATCH /tickets/:id/move":"{ column_id, position } — the target column decides the new status","PATCH /tickets/bulk_update":"{ ticket_ids: [], updates: { status|priority|assignee_id|column_id } }. All or nothing: one refused ticket answers 422 and changes none","DELETE /tickets/:id":"permanent; prefer archive","POST|DELETE /tickets/:id/archive":"archive / restore","GET /tickets/:id/history":"the change timeline (who changed what, when)","GET|POST|DELETE /tickets/:id/watch":"follow a ticket (POST) or stop (DELETE); GET /watchers lists them","POST /tickets/:id/links":"{ target_key: \"PAL-7\" | target_id, link_type: blocks|relates|duplicates }","DELETE /tickets/:id/links/:link_id":"remove a link","GET|POST /tickets/:id/attachments":"any file type; DELETE /attachments/:attachment_id"},"comments":{"GET|POST /tickets/:ticket_id/comments":"{ comment: { content } } — authorship comes from the session; @username mentions notify that member","PATCH|DELETE /comments/:id":"author or company owner/admin only. { comment: { content } }: the text is the only writable field"},"labels":{"GET|POST /boards/:board_id/labels":"{ label: { name, color } } — color is #RRGGBB","PATCH|DELETE /labels/:id":"rename, recolor, remove (a label never changes board)"},"me":{"GET /my-work?company_id=":"assigned / overdue / stale / watching / reported, across every board of one company"},"search":{"GET /search?company_id=\u0026q=":"company-wide ticket search across EVERY board. \u0026limit= (max 50), \u0026board_id= to narrow, \u0026archived=all|only to include or isolate the archive (the default is open work only). Results carry key, board, column, status, assignee, labels, a snippet and a deep link","GET /search/facets?company_id=":"the values an operator accepts here: boards, members, labels, statuses, types, priorities, flags"},"ai":{"POST /tickets/:id/ai":"{ task: \"summarize\" | \"triage\" } — reads the ticket and its comments and answers with a SUGGESTION; it never writes to the ticket"},"notifications":{"GET /notifications?company_id=":"the bell: assignments, @mentions and comments across every board of ONE company","GET /notifications/unread-count?company_id=":"cheap poll","POST /notifications/:id/read, POST /notifications/read-all":"mark read","GET|PATCH /notifications/settings?company_id=":"{ email_notifications: bool } — per company"}},"examples":["curl -c jar -X POST https://techtools.cz/shared-auth-api/login -H \"Content-Type: application/json\" -d '{\"username\":\"you\",\"password\":\"…\"}'","curl -b jar \"https://techtools.cz/kanban-api/boards?company_id=1\"","curl -b jar \"https://techtools.cz/kanban-api/boards/1/tickets\"","curl -b jar -X POST \"https://techtools.cz/kanban-api/boards/1/tickets\" -H \"Content-Type: application/json\" -d '{\"ticket\":{\"column_id\":1,\"title\":\"Fix the login redirect\",\"ticket_type\":\"bug\",\"priority\":\"p1\"}}'","curl -b jar -X POST \"https://techtools.cz/kanban-api/tickets/42/comments\" -H \"Content-Type: application/json\" -d '{\"comment\":{\"content\":\"@alice can you look?\"}}'","curl -b jar \"https://techtools.cz/kanban-api/boards/1/reports\"","curl -b jar -o board.csv \"https://techtools.cz/kanban-api/boards/1/export\"","curl -b jar \"https://techtools.cz/kanban-api/search?company_id=1\u0026q=payment+gateway+is:archived\"","curl -b jar \"https://techtools.cz/kanban-api/search?company_id=1\u0026q=assignee:me+type:bug+priority:p1\"","curl -b jar \"https://techtools.cz/kanban-api/companies/1/settings\"","curl -b jar -X PATCH \"https://techtools.cz/kanban-api/companies/1/settings\" -H \"Content-Type: application/json\" -d '{\"settings\":{\"fields\":{\"acceptance_criteria\":false,\"technical_notes\":false}}}'"],"errors":{"401":"not signed in (AUTH_REQUIRED)","400":"a query parameter that must be text arrived nested, e.g. ?status[x]=y (BAD_PARAM)","403":"a member of that company, but not owner/admin for a structure change (FORBIDDEN)","404":"no such record, a record of a company you are not a member of, or one on a deleted board (NOT_FOUND)","422":"validation failed (`details` lists the messages), or a company workflow rule refused the write (`code`: RULE_BLOCKED, `rule`: which one)"}}