← API Index

Use the kanban (ticket management) API

A lightweight kanban board for the admin area. It lets a Betrieb organize internal tasks as tickets that move through states on one or more boards. All endpoints live under /api/admin/kanban/ and require a session authenticated as an admin.

Entity model

On first access an empty installation is auto-seeded with a Default board and the four states Inbox / Scheduled / In Progress / Done.

Every mutation returns a TicketResult (action, result, op, plus whichever of id / detail_id / board_id / name applies). On invalid input a mutation answers HTTP 400 with the exit code in the X-oekobox-error header.

Boards

States

Tickets

Ticket notes

A typical flow

  1. list the boards, pick a board_id (or add one).
  2. ticketlist?board_id=N to render the columns (from state/list data embedded in the response) and the cards.
  3. Drag a card → ticket/update with the new state (and sorting).
  4. Open a card → ticket?id=N for its details and attachments; add progress via detail/add.

All endpoints support the usual response formats via oo-rf (json, md, html, openapi, …), so any endpoint documents itself live — e.g. append ?oo-rf=html to try it in the browser.