Taakr's REST API: Hoe Teams Hun Werkflow Automatiseren

Projectmanagement-tools worden pas echt krachtig op het moment dat ze naadloos aansluiten op je bestaande werkflow. Dat is precies waarom we bij het bouwen van Taakr de API als eerste-klas feature hebben behandeld — niet als bijzaak.

In dit artikel duiken we in de Taakr REST API: wat je ermee kunt, hoe je het integreert, en hoe wij het zelf gebruiken om taken volledig geautomatiseerd te verwerken.

Waarom een Open API Essentieel Is

De meeste projectmanagement-tools behandelen hun API als enterprise-feature. Je betaalt meer, krijgt toegang tot een subset van endpoints, en de documentatie is halfslachtig.

Bij Taakr hebben we dat anders gedaan. De API is beschikbaar vanaf het Team-abonnement, volledig gedocumenteerd, en werkt op dezelfde REST-principes die elke developer kent. Geen GraphQL-complexiteit, geen webhook-hell, gewoon clean HTTP.

Waarom? Omdat we het zelf ook gebruiken.

De Basisprincipes

Authentificatie gaat via een API key die je aanmaakt in je account-instellingen. De key begint altijd met tk_live_ en stuur je mee als Bearer token:

bash

curl -H "Authorization: Bearer tk_live_xxx" \
  https://www.taakr.nl/api/v1/boards

Dat is alles. Geen OAuth-dans, geen token-refresh-ellende. Simpel en voorspelbaar.

De Kernoperaties

Boards ophalen

GET /api/v1/boards

Geeft een array van al je boards terug, inclusief de lijsten en hun IDs. Die list-IDs heb je nodig om kaarten aan te maken of te verplaatsen.

Kaarten aanmaken

POST /api/v1/cards
{
  "listId": "cmmxxxx",
  "title": "Implementeer dark mode",
  "description": "Toggle in user settings, persistent via localStorage",
  "labelIds": ["cmm-label-yyy"]
}

Een kaart aanmaken is één API-call. De response geeft het ID terug, dat je kunt gebruiken voor vervolgacties.

Kaarten verplaatsen

PATCH /api/v1/cards
{
  "id": "cmm-card-zzz",
  "listId": "cmm-gereed-lijst-id"
}

Van Todo naar Gereed in één call. Zo simpel is het.

Comments posten

POST /api/v1/cards/{id}/comments
{
  "text": "Geïmplementeerd in commit abc123. Dark mode actief voor alle gebruikers."
}

Comments zijn ideaal voor automatische statusupdates — van je CI/CD pipeline, van een AI-agent, of van een monitoring-script.

Praktijkvoorbeeld: AI-Gedreven Taakbeheer

Een concreet voorbeeld van hoe wij Taakr intern gebruiken: onze AI-assistent (RobBot) monitort elk uur alle boards op kaarten met het label 'AI' in de Todo-lijst.

Als zo'n kaart gevonden wordt: 1. Pakt RobBot de taak op 2. Voert de opdracht uit (code schrijven, analyse maken, etc.) 3. Post een comment met het verslag 4. Verplaatst de kaart naar 'Gereed' 5. Stuurt een notificatie

De code voor stap 1:

typescript

const response = await fetch('https://www.taakr.nl/api/v1/boards', {
  headers: { 'Authorization': `Bearer ${TAAKR_API_KEY}` }
});
const boards = await response.json();

for (const board of boards) {
  const boardDetail = await fetch(`/api/v1/boards/${board.id}`, ...);
  const aiCards = boardDetail.lists
    .flatMap(list => list.cards)
    .filter(card => 
      card.labels.some(l => l.name === 'AI') && 
      isTodoList(card.listId)
    );
  // Verwerk elke AI-taak...
}

Dit patroon werkt voor elke automatiseringsuse-case: sprint-planning, bug-triage, deployment-tracking, je noemt het.

CI/CD Integratie

Een andere populaire use-case is het koppelen van je deployment-pipeline aan Taakr. Stel je voor:

Bij PR merge: Verplaats de bijbehorende taakkaart naar 'In Review'
Bij succesvolle build: Verplaats naar 'Ready for Deploy'
Bij productie-deploy: Verplaats naar 'Gereed' en post een comment met het build-nummer

Met GitHub Actions ziet dat er zo uit:

yaml

- name: Update Taakr card
  run: |
    curl -X PATCH https://www.taakr.nl/api/v1/cards \
      -H "Authorization: Bearer ${{ secrets.TAAKR_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"id": "${{ env.CARD_ID }}", "listId": "${{ env.DONE_LIST_ID }}"}'

Teams en Rechten

De API werkt op board-niveau. Als je een API key aanmaakt, heb je toegang tot alle boards binnen je organisatie. Wil je fine-grained access? Maak een aparte gebruiker aan voor je integratie — dan heb je volledige controle.

Een feature die we actief aan het bouwen zijn: per-board API keys met read-only of write-only rechten. Nuttig als je een externe partij toegang wilt geven zonder dat ze alles kunnen zien of aanpassen.

Webhooks — Binnenkort

De API werkt nu als pull-model: je poll voor updates. We begrijpen dat dat niet ideaal is voor alle use-cases. Webhooks staan hoog op onze roadmap — zodat Taakr jou kan notificeren zodra er een kaart aangemaakt, verplaatst of geclosed wordt.

Tijdelijk kun je de API al prima pollen met een interval van 30-60 seconden, wat voor de meeste workflows meer dan voldoende is.

Data in Europa, API in Europa

Eén ding dat we hier expliciet willen benoemen: je API-requests gaan naar servers in Frankfurt, Duitsland. Je data verlaat de EU nooit. Geen transatlantische API-calls, geen dataverwerking buiten AVG-bereik.

Voor bedrijven in gereguleerde sectoren (zorg, finance, overheid) is dat geen nice-to-have — het is een harde requirement. Taakr voldoet daar standaard aan, zonder extra configuratie.

Aan de Slag

Maak een gratis account op taakr.nl. Upgrade naar het Team-plan voor API-toegang, genereer je eerste key, en bouw je integratie.

Heb je een interessante use-case of loop je ergens tegenaan? Stuur ons een bericht — we bouwen Taakr mede op basis van wat teams daadwerkelijk nodig hebben.

Taakr: Europese Kanban-tool met een open API. Gebouwd voor teams die hun werkflow willen automatiseren zonder concessies te doen aan privacy.