Chat met Jurre
← Alle koppelingen
Voor ontwikkelaars

Boldcaster aansluiten op je eigen systemen

Alles wat Boldcaster naar buiten aanbiedt staat op deze pagina. De lijst hieronder komt rechtstreeks uit de koppeling zelf, dus hij loopt nooit achter op wat er werkelijk draait.

Voordat je begint

Er zijn twee deuren naar dezelfde gegevens: de AI-koppeling voor een assistent, en de REST API voor al het andere. Ze hebben elk een eigen schakelaar, want toestemming voor het een is geen toestemming voor het ander. Verder gelden voor allebei dezelfde drie voorwaarden, en gaat er iets mis, dan zegt het antwoord welke van de drie het was.

  1. 1De koppeling staat aan voor die organisatie. Een owner zet hem aan onder Koppelingen, per deur apart.
  2. 2Het onderdeel is vrijgegeven. Per onderdeel kiest een owner of het mee mag: KPI's, prioriteiten, weektaken, team, gesprekken en financieel.
  3. 3Jij mag het zelf ook zien. Je werkt met je eigen account, dus je krijgt precies de rechten die je in Boldcaster hebt, geen andere. Een API-sleutel handelt namens de persoon die hem aanmaakte en ziet dus ook niet meer dan die persoon.

Elke aanroep komt in het logboek van de organisatie, ook een geweigerde. Dat is met opzet: een koppeling die meekijkt hoort zichtbaar te zijn voor wie hem heeft aangezet.

De AI-koppeling (MCP)

Claude, ChatGPT en Vibe praten dit protocol. Voeg het adres toe als connector en log in met je Boldcaster-account.

https://boldcaster.com/mcp

Stap voor stap per app staat op de pagina over de AI-koppeling.

De REST API

Voor alles wat geen AI-assistent is: Power BI, een script, of het datawarehouse van je klant. Dezelfde gegevens en dezelfde rechten als hierboven, in gewone JSON.

https://boldcaster.com/api/v1

Een owner maakt een sleutel aan onder Koppelingen, bij API-sleutels. Die gaat mee in de Authorization-header; een sleutel geldt voor één organisatie.

curl -H "Authorization: Bearer bc_live_..." \
  "https://boldcaster.com/api/v1/team?org_id=..."

Vraag het adres hierboven zonder sleutel op en je krijgt de lijst met endpoints terug, met hun parameters.

Een sleutel toetsen doe je met één aanroep: 200 met een geldige sleutel, 401 zonder. Dat is ook het adres dat Zapier en Make gebruiken om een ingevoerde sleutel te controleren. https://boldcaster.com/api/v1/wie-ben-ik

Webhooks

Met een webhook stuurt Boldcaster zelf een bericht naar jouw adres zodra er iets gebeurt. De eigenaar van de organisatie maakt hem aan in de app, onder Koppelingen bij Webhooks. Je hebt er geen API-sleutel voor nodig. Dit zijn de gebeurtenissen:

  • taak.aangemaakt Er komt een taak bij onder een prioriteit, in een project of als losse taak.
  • taak.gewijzigd De titel, deadline, eigenaar of status van een taak verandert, of een afgevinkte taak gaat weer open.
  • taak.klaar Iemand vinkt een taak af.
  • prioriteit.aangemaakt Er komt een rock of OKR bij.
  • prioriteit.afgerond Een rock of OKR wordt afgerond.
  • kpi.rood Een meting komt op rood uit tegen het kwartaaldoel.
  • reflectie.ingediend Iemand dient een maand-, kwartaal- of jaarreflectie in. Alleen wie en welke periode, niet de inhoud.

Elk bericht is een POST met JSON. De kop zegt welke gebeurtenis het is, de inhoud staat onder gegevens.

POST https://jouw-adres.example/boldcaster
X-Boldcaster-Event: taak.klaar
X-Boldcaster-Delivery: 5f0c2a1e-...
X-Boldcaster-Signature: t=1791629208,v1=9b2f...

{
  "id": "2b41810e-...",
  "gebeurtenis": "taak.klaar",
  "tijdstip": "2026-10-10T11:41:26Z",
  "organisatie_id": "...",
  "gegevens": {
    "taak": { "id": "...", "nummer": 156, "titel": "Offerte versturen",
              "klaar": true, "status": "open", "deadline": null, "eigenaar_id": "..." },
    "onderdeel": { "id": "...", "titel": "Nieuwe klanten Q4", "soort": "prioriteit" }
  }
}

Controleer de handtekening voordat je iets met een bericht doet. Het is een HMAC-SHA256 over het tijdstip, een punt en de ruwe inhoud, met de signing secret die je bij het aanmaken kreeg.

import { createHmac, timingSafeEqual } from "node:crypto";

// body: de ruwe tekst van het bericht, niet de geparste JSON
function echt(body, header, geheim) {
  const { t, v1 } = Object.fromEntries(header.split(",").map((d) => d.split("=")));
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const verwacht = createHmac("sha256", geheim).update(t + "." + body).digest("hex");
  return v1.length === verwacht.length && timingSafeEqual(Buffer.from(v1), Buffer.from(verwacht));
}

Antwoord binnen tien seconden met een 2xx. Lukt dat niet, dan proberen we het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2 uur en 12 uur. Een bericht kan dus twee keer aankomen: gebruik het id om dubbelen te herkennen. Na vijftien mislukte berichten achter elkaar zetten we de webhook uit en krijgt de eigenaar een melding.

Taken uit een besloten project gaan niet mee, en toelichtingen, notities en de inhoud van een reflectie ook niet. Wat je verder nodig hebt haal je op via de REST API. Het adres moet https zijn, een domeinnaam hebben en mag niet doorsturen.

Wat je kunt opvragen

Deze veranderen niets. Ze geven dezelfde cijfers en stoplichten als de schermen in Boldcaster, uitgerekend door dezelfde code.

organisatiesMijn organisaties

De Boldcaster-organisaties waar deze gebruiker bij hoort en waar de AI-koppeling aanstaat, met zijn rol en welke onderdelen vrijgegeven zijn. Roep dit eerst aan: elke andere tool vraagt een org_id.

Alleen via de AI-koppeling. Een API-sleutel geldt al voor één organisatie, dus valt er niets te kiezen.
teamTeam

Het team van een organisatie zoals het teamoverzicht in Boldcaster het toont: naam, rol (de rechten in Boldcaster), functietitel en user_id, en per bedrijfsproces wie eindverantwoordelijk is en welke rollen eronder vallen (Team > Teamleden, weergave Functies). Een rol is een plek met een eigen naam: er zit iemand op, of hij is open (`wie` is dan null, en hij staat ook in `open_rollen`). `zonder_rol` zijn de teamleden die geen proces leiden en op geen enkele rol zitten. Gebruik de user_id om eigenaren van prioriteiten, KPI's en taken te koppelen.

GET/api/v1/team
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
prioriteitenPrioriteiten

De prioriteiten (rocks en OKR's) van een kwartaal, zoals het Prioriteiten-scherm ze toont: titel, soort, eigenaar, voortgang, stand en deadline. Rocks en OKR's staan door elkaar; `soort` zegt welke het is. De stand volgt de kaart in Boldcaster en legt de voortgang naast de verstreken looptijd (startdatum tot deadline, anders het kwartaal): 'op koers' als de voortgang de tijd bijhoudt, 'aandacht nodig' vanaf 80% daarvan, 'loopt achter' daaronder, 'nog niet gestart' als de prioriteit nog moet beginnen, 'geen taken' als er niets is om op te meten. Zet alleen_aandacht aan voor de vraag welke prioriteiten achterlopen.

GET/api/v1/prioriteiten
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
kwartaalstringoptioneel
Bijvoorbeeld "Q3-2026". Leeg is het lopende kwartaal.
alleen_aandachtja/neeoptioneel
Alleen wat achterloopt, aandacht nodig heeft of over de deadline is.
kpi_scorebordKPI-scorebord

Het KPI-scorebord van een kwartaal, uitgerekend door dezelfde code als het scherm in Boldcaster: per KPI het kwartaaldoel, de huidige stand, het stoplicht en de eigenaar. Een KPI wordt per week óf per maand gemeten (`cadans`); cumulatieve KPI's worden pro rata naast het doel gelegd. Groen is op of boven de lijn, oranje vanaf 80%, rood daaronder. Reken zelf niets opnieuw uit: dit is wat de klant op zijn scherm ziet.

GET/api/v1/kpi-scorebord
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
kwartaalstringoptioneel
Bijvoorbeeld "Q3-2026". Leeg is het lopende kwartaal.
weektakenWeektaken

De taken op het weekbord van een organisatie voor één ISO-week, per persoon: titel, status, of hij klaar is, en de prioriteit (rock_id) waar hij bij hoort. Handig voor vragen als 'wat staat er deze week open bij Mark?'.

GET/api/v1/weektaken
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
weekstringoptioneel
ISO-week, bijvoorbeeld "2026-W40". Leeg is deze week.
waarderingBedrijfswaardering

De vastgelegde bedrijfswaarderingen van een organisatie, nieuwste eerst: per meting de periode, de omzet, de genormaliseerde EBITDA, de multiple en de aandelenwaarde. Dit is de historie zoals opgeslagen op het moment van meten; reken niets opnieuw uit. Let op: het bedrag op het waarderingsscherm kan hoger of lager liggen dan de laatste meting hier, want dat scherm rekent live met de huidige formule en slaat pas op als de ondernemer bewaart. Noem dat verschil als het ter sprake komt in plaats van één van de twee als de waarheid te presenteren. Metingen zonder cijfers (een openstaande uitnodiging aan de boekhouder) blijven eruit. Bevat geen facturen of grootboekregels: Boldcaster bewaart alleen samengestelde cijfers.

GET/api/v1/waardering
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
aantalgeheel getaloptioneel
Hoeveel metingen, nieuwste eerst. Standaard 8.
gesprekkenFunctioneringsgesprekken

De functioneringsgesprekken van een organisatie: per gesprek wie, met wie, welke soort, de datum, of het is afgerond en de eindclassificatie (A tot en met D). Bevat bewust geen salarisgegevens en geen vrije tekst uit het gesprek zelf; wie de inhoud nodig heeft opent het gesprek in Boldcaster. Je ziet alleen de gesprekken die je in Boldcaster ook zou zien: met toegang tot Team het hele team, anders je eigen gesprekken en die waarin je zelf de gespreksleider bent.

GET/api/v1/gesprekken
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
jaargeheel getaloptioneel
Alleen de gesprekken van dit jaar. Leeg is alle jaren.
alleen_openja/neeoptioneel
Alleen gesprekken die nog niet zijn afgerond.
sessienotitiesSessienotities

De notities van sessies met de coach of het MT: per sessie de datum, het soort sessie, de samenvatting, highlights, besluiten, learnings en de actiepunten met eigenaar en deadline. Gebruik dit om een volgende sessie voor te bereiden of na te gaan wat er is afgesproken. Een notitie met status 'concept' is nog niet nagelezen en alleen zichtbaar voor de coach.

GET/api/v1/sessienotities
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
aantalgeheel getaloptioneel
Hoeveel sessies terug, de nieuwste eerst. Standaard 5.
takenTaken

De taken van een organisatie: onder een prioriteit (rock of OKR), in een project, en de losse taken. Per taak het nummer, de omschrijving, waar hij bij hoort, de eigenaar, de stand, de deadline, de urgentie, labels, de inschatting in uren, de bestede uren en of hij herhaalt. Standaard alleen wat nog open staat. Filter op soort, op één prioriteit of project, of op eigenaar, of vraag één taak op met zijn nummer. De stand is die van het taakvenster in Boldcaster: open, bezig, wacht op feedback, klaar of vervallen. Vervallen is afgesloten zonder gedaan te zijn. Er komen hoogstens 200 taken terug; staat 'afgekapt' op true, filter dan verder.

GET/api/v1/taken
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
soortkeuzeoptioneel
Alleen taken onder prioriteiten, in projecten, of de losse taken. Leeg is alles.
Keuzes: prioriteit, project, los
hoort_bij_iduuidoptioneel
De id van één prioriteit (uit `prioriteiten`) of één project (uit `projecten`).
eigenaar_user_iduuidoptioneel
Uit de tool `team`.
ook_afgeslotenja/neeoptioneel
Ook taken die klaar of vervallen zijn. Standaard alleen wat open staat.
nummergeheel getaloptioneel
Het nummer van één taak, zoals in Boldcaster (#156). Geeft die ene taak terug, ook als hij klaar of vervallen is; de andere filters tellen dan niet.
projectenProjecten

De lopende projecten van een organisatie: titel, eigenaar, looptijd, of het besloten is (alleen zichtbaar voor wie eraan meewerkt) hoeveel taken er open staan en hoeveel uur eraan is besteed. Een project is werk met een begin en een eind dat geen kwartaalprioriteit is. De taken zelf haal je op met `taken` en de id van het project. Je ziet alleen de projecten die je in Boldcaster ook ziet.

GET/api/v1/projecten
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
reflectiesReflecties

De maand- of kwartaalreflecties van een organisatie voor één periode: per persoon wat goed ging, wat beter kan, wat hij leerde, de focus voor de volgende periode en het energieniveau. Je ziet wat je in Boldcaster ook ziet: je eigen reflectie altijd, die van je team pas als iedereen heeft ingediend en jij ook. Staat `team_zichtbaar` op false, zeg dan dat de ronde nog niet open is en raad niet wat collega's schreven. Zonder periode komt de laatste periode terug waarin iets is ingevuld.

GET/api/v1/reflecties
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
soortkeuzeverplicht
Maandreflectie of kwartaalreflectie.
Keuzes: maand, kwartaal
periodestringoptioneel
Maand als "2026-09", kwartaal als "Q3-2026". Leeg is de laatste met inhoud.
urenBestede uren

De bestede uren van een organisatie over een periode: per persoon hoeveel uur, en waaraan (per prioriteit, project of de losse taken). Dezelfde cijfers als het urenoverzicht in Boldcaster. Geef `van` en `tot` mee als JJJJ-MM-DD, beide dagen tellen mee. Zonder periode komt de lopende maand terug. Voor een maand: de eerste en de laatste dag van die maand. Wie niet alle uren mag zien, krijgt alleen zijn eigen uren terug; het antwoord zegt dat erbij. Uren per losse taak, zonder periode, staan in `taken`.

GET/api/v1/uren
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
vanstringoptioneel
Eerste dag van de periode, als JJJJ-MM-DD. Leeg is de eerste van deze maand.
totstringoptioneel
Laatste dag van de periode, als JJJJ-MM-DD. Leeg is de laatste van deze maand.
user_iduuidoptioneel
Alleen de uren van deze persoon, uit de tool `team`. Leeg is iedereen.

Wat je kunt vastleggen

Deze schrijven wel. Ze werken alleen als de organisatie niet op alleen lezen staat, en horen pas te draaien na een expliciet akkoord van de gebruiker.

prioriteit_aanmakenPrioriteit aanmaken

Maakt één prioriteit (rock of OKR) aan in Boldcaster, net als de knop op het Prioriteiten-scherm. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel met titel, soort, eigenaar, kwartaal en een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Maak er nooit meerdere aan op eigen initiatief. Een goede rock is één uitkomst die aan het eind van het kwartaal af is, meetbaar, met precies één eigenaar. Geen doorlopende taak, geen wens. Hooguit drie tot vijf per persoon per kwartaal; heeft iemand er al zoveel, zeg dat dan eerst. Rock of OKR kies je expliciet (`soort`); ze staan in dezelfde lijst. Een OKR krijgt hier nog geen key results; die voegt de gebruiker in Boldcaster toe. De eigenaar is een user_id uit de tool `team`.

POST/api/v1/prioriteit-aanmaken
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
titelstringverplicht
Kort en als uitkomst geformuleerd.
soortkeuzeverplicht
Rock of OKR. Geen standaard: kies bewust.
Keuzes: rock, okr
eigenaar_user_iduuidverplicht
Uit de tool `team`.
kwartaalstringoptioneel
Bijvoorbeeld "Q4-2026". Leeg is het lopende kwartaal.
deadlinestringoptioneel
Datum als JJJJ-MM-DD. Leeg is het einde van het kwartaal.
omschrijvingstringoptioneel
Waarom deze prioriteit, en wanneer is hij af.
bevestigcodestringoptioneel
Leeg bij de eerste aanroep. Daarna de code uit het voorstel, na een ja van de gebruiker.
kpi_meting_invoerenKPI-meting invoeren

Zet één meting op een KPI in Boldcaster, net als het invoerveld op het KPI-scorebord. Overschrijft een eerdere meting in dezelfde periode. Een KPI wordt per week óf per maand gemeten; de periode moet in die cadans ("2026-W40" of "2026-09"). Leeg is de lopende week of maand. Vraag de KPI's en hun cadans eerst op met `kpi_scorebord`. Komt de KPI op oranje of rood, dan eist Boldcaster een toelichting. Vraag de gebruiker daar dan om in plaats van er zelf een te verzinnen. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel (met de waarde die er nu staat, als die er is) en een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code.

POST/api/v1/kpi-meting-invoeren
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
kpi_iduuidverplicht
Uit de tool `kpi_scorebord`.
waardegetalverplicht
De gemeten waarde in de eenheid van de KPI.
periodestringoptioneel
"2026-W40" bij een week-KPI, "2026-09" bij een maand-KPI. Leeg is de lopende periode.
toelichtingstringoptioneel
Verplicht als de KPI oranje of rood wordt.
bevestigcodestringoptioneel
Leeg bij de eerste aanroep. Daarna de code uit het voorstel, na een ja van de gebruiker.
taak_toevoegenTaak toevoegen

Zet één taak in Boldcaster: onder een bestaande prioriteit (rock of OKR), in een bestaand project, of als losse taak die nergens bij hoort. Geef `prioriteit_id` of `project_id` mee; zonder een van beide wordt het een losse taak. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel met een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Zoek de prioriteit eerst op met `prioriteiten`, het project met `projecten` en de eigenaar met `team`. Een taak is één concrete stap met één eigenaar, geen nieuwe prioriteit. Zet een taak niet onder een prioriteit waar hij niet aan bijdraagt; dan is hij los. Een subtaak maak je met `onder_taak_nummer`: het nummer van de taak waar hij onder komt, uit `taken`. Hij hoort dan vanzelf bij dezelfde prioriteit of hetzelfde project; geef die niet mee. Subtaken gaan één laag diep en herhalen niet. Zonder eigenaar krijgt een subtaak de eigenaar van zijn taak.

POST/api/v1/taak-toevoegen
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
prioriteit_iduuidoptioneel
De id van de rock of OKR, uit `prioriteiten`. Niet samen met project_id.
project_iduuidoptioneel
De id van het project, uit `projecten`. Niet samen met prioriteit_id.
onder_taak_nummergeheel getaloptioneel
Maakt er een subtaak van: het nummer van de taak waar hij onder komt, uit `taken`. Niet samen met prioriteit_id, project_id of herhalen.
omschrijvingstringverplicht
De taak, kort en als handeling: wie doet wat.
eigenaar_user_iduuidoptioneel
Uit de tool `team`. Leeg is niemand.
deadlinestringoptioneel
Datum als JJJJ-MM-DD. Leeg is geen deadline.
herhalenkeuzeoptioneel
Laat de taak terugkomen: zodra hij klaar is, staat de volgende er. Onder een prioriteit stopt dat als de prioriteit is afgerond. Leeg is eenmalig.
Keuzes: dag, week, maand, kwartaal, jaar
groottekeuzeoptioneel
Hoe groot de taak is: klein (een paar uur), middel (een dag) of groot (een paar dagen). Vult de inschatting, en de voortgang van de prioriteit weegt een grote taak zwaarder. Niet samen met inschatting_uren.
Keuzes: klein, middel, groot
inschatting_urengetaloptioneel
De inschatting in uren, als je het preciezer weet dan een grootte.
bevestigcodestringoptioneel
Leeg bij de eerste aanroep. Daarna de code uit het voorstel, na een ja van de gebruiker.
kpi_aanmakenKPI aanmaken

Zet één nieuwe KPI op het KPI-scorebord in Boldcaster. Het doel en het proces stelt de gebruiker daarna in de app in. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel met een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Kijk eerst met `kpi_scorebord` of de KPI er niet al staat. Een KPI meet een uitkomst of een stuurgetal dat je elke week of maand invult, geen eenmalig project (dat is een prioriteit). Meetsoort "teller" telt op binnen het kwartaal (aantal leads, omzet); "stand" is een momentopname (aantal klanten, marge in %).

POST/api/v1/kpi-aanmaken
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
naamstringverplicht
Hoe de KPI op het scorebord heet.
eenheidstringoptioneel
Bijvoorbeeld "EUR", "%", "stuks".
eigenaar_user_iduuidverplicht
Uit de tool `team`. Elke KPI heeft één eigenaar.
meetsoortkeuzeverplicht
Teller telt op, stand is een momentopname.
Keuzes: teller, stand
cadanskeuzeverplicht
Wordt hij per week of per maand ingevuld?
Keuzes: week, month
lager_is_beterja/neeoptioneel
Waar bij churn, kosten of doorlooptijd. Standaard nee.
bevestigcodestringoptioneel
Leeg bij de eerste aanroep. Daarna de code uit het voorstel, na een ja van de gebruiker.
strategie_bijwerkenStrategie: wijziging voorstellen

Zet een voorstel klaar om een of meer tekstvelden van het strategiecanvas in Boldcaster te wijzigen: bhag (BHAG), purpose (Purpose), dna (DNA), jaarthema (Jaarthema), core_customer (Kernklant), core_competence (Kerncompetentie), brand_promise (Merkbelofte), sandbox_geo (Sandbox: regio), sandbox_niche (Sandbox: doelgroep), sandbox_product (Sandbox: product), profit_per_x (Winst per X), profit_per_x_toelichting (Winst per X: toelichting). Deze tool wijzigt zelf niets. Het voorstel komt in Boldcaster te staan, met per veld wat er nu staat en wat het wordt, en een eigenaar, admin of MT-lid keurt het daar goed of af op de strategiepagina. Zeg dat ook tegen de gebruiker. Laat de gebruiker eerst zien wat je gaat voorstellen. Een veld dat je niet meegeeft blijft zoals het is. Stel alleen voor wat de gebruiker in het gesprek echt heeft besloten, in zijn eigen woorden, en vul niets aan wat niet gezegd is. Alleen een eigenaar, admin of MT-lid kan een wijziging in de strategie voorstellen; bij een ander weigert Boldcaster.

POST/api/v1/strategie-bijwerken
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
veldenobjectverplicht
Alleen de velden die veranderen, met de nieuwe tekst.
weektaak_toevoegenWeektaak toevoegen

Zet één taak op het weekbord in Boldcaster, in de kolom voor nieuw werk. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel met een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Zonder `voor_user_id` is de taak van de gebruiker zelf. Een taak voor een collega kan alleen een eigenaar, admin of MT-lid zetten. Hoort de taak bij een prioriteit, geef dan `prioriteit_id` mee (uit `prioriteiten`).

POST/api/v1/weektaak-toevoegen
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
titelstringverplicht
De taak, kort: wat moet er gebeuren.
weekstringoptioneel
ISO-week, bijvoorbeeld "2026-W41". Leeg is deze week.
voor_user_iduuidoptioneel
Uit de tool `team`. Leeg is de gebruiker zelf.
prioriteit_iduuidoptioneel
De rock of OKR waar hij bij hoort.
bevestigcodestringoptioneel
Leeg bij de eerste aanroep. Daarna de code uit het voorstel, na een ja van de gebruiker.
dagprioriteiten_zettenDagprioriteiten zetten

Zet de drie prioriteiten van de dag voor de gebruiker zelf in Boldcaster, zoals op het scherm Dagplanning. Alleen voor jezelf, nooit voor een collega. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel waarin staat wat er nu staat en wat het wordt, met een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Een prioriteit die je niet meegeeft blijft zoals hij is. Hooguit drie: wie er meer noemt, vraag welke drie vandaag echt moeten.

POST/api/v1/dagprioriteiten-zetten
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
datumstringoptioneel
JJJJ-MM-DD. Leeg is vandaag.
prioriteit_1stringoptioneel
De belangrijkste van de dag.
prioriteit_2stringoptioneel
De tweede.
prioriteit_3stringoptioneel
De derde.
bevestigcodestringoptioneel
Leeg bij de eerste aanroep. Daarna de code uit het voorstel, na een ja van de gebruiker.
sessienotitie_schrijvenSessienotitie schrijven

Legt een sessienotitie vast als concept: de coach leest hem na in Boldcaster en stelt hem vast, pas dan ziet de klant hem. Gebruik alleen wat in de sessie is gezegd en besloten. Verzin geen eigenaren of deadlines bij actiepunten; laat ze leeg als ze niet zijn genoemd. Werkt in twee stappen: de eerste aanroep geeft een voorstel met een bevestigcode, de tweede (na een ja van de gebruiker, met dezelfde invoer en de code) schrijft.

POST/api/v1/sessienotitie-schrijven
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
datumstringverplicht
De datum van de sessie als JJJJ-MM-DD.
titelstringverplicht
Korte titel, zoals 'Kwartaalsessie Q4'.
soortkeuzeverplicht
Het soort sessie.
Keuzes: strategie, kwartaal, maand, check_in, overig
samenvattingstringverplicht
Wat er is besproken, in gewone zinnen.
highlightsarrayoptioneel
De belangrijkste punten, één per regel.
besluitenarrayoptioneel
Wat er is besloten.
learningsarrayoptioneel
Wat het team heeft geleerd.
actiepuntenarrayoptioneel
De actiepunten uit de sessie.
bevestigcodestringoptioneel
Leeg bij de eerste aanroep. Daarna de code uit het voorstel, na een ja van de gebruiker.
taak_bijwerkenTaak bijwerken

Werk één bestaande taak bij in Boldcaster: de stand (open, in_uitvoering, wacht_op_feedback, voltooid of vervallen), de eigenaar, de deadline, herhalen, de grootte of de omschrijving. Geef alleen mee wat moet veranderen. Vervallen is afsluiten zonder dat het gedaan is: de taak staat nergens meer open en telt niet mee in de voortgang. Gebruik voltooid alleen als het werk echt af is. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel met een bevestigcode, met per veld wat er nu staat en wat het wordt. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Zoek de taak eerst op met `taken`. Verwijderen kan niet via de koppeling.

POST/api/v1/taak-bijwerken
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
taak_iduuidverplicht
De id van de taak, uit `taken`.
standkeuzeoptioneel
De nieuwe stand.
Keuzes: open, in_uitvoering, wacht_op_feedback, voltooid, vervallen
eigenaar_user_idtekstoptioneel
Uit de tool `team`. null haalt de eigenaar eraf.
deadlinetekstoptioneel
Datum als JJJJ-MM-DD. null haalt de deadline eraf.
herhalenkeuzeoptioneel
Hoe vaak de taak terugkomt. "niet" zet herhalen uit.
Keuzes: niet, dag, week, maand, kwartaal, jaar
omschrijvingstringoptioneel
De nieuwe tekst.
groottekeuzeoptioneel
Klein (een paar uur), middel (een dag) of groot (een paar dagen). Vult de inschatting; de voortgang van de prioriteit weegt een grote taak zwaarder. Niet samen met inschatting_uren.
Keuzes: klein, middel, groot
inschatting_urentekstoptioneel
De inschatting in uren. null haalt hem eraf.
bevestigcodestringoptioneel
Leeg bij de eerste aanroep. Daarna de code uit het voorstel, na een ja van de gebruiker.
project_aanmakenProject aanmaken

Maakt één project aan in Boldcaster. Een project is werk met een begin en een eind dat geen kwartaalprioriteit is; het staat los van de rocks en OKR's en hoort niet bij een kwartaal. Werkt in twee stappen. De eerste aanroep wijzigt niets en geeft een voorstel met een bevestigcode. Laat dat voorstel aan de gebruiker zien, met de naam van de organisatie, en roep de tool pas na een expliciet ja opnieuw aan met dezelfde invoer en die code. Kijk eerst met `projecten` of het project er al staat. Is het één uitkomst die dit kwartaal af moet en waar het bedrijf op stuurt, dan is het een prioriteit (`prioriteit_aanmaken`); is het één handeling, dan is het een taak (`taak_toevoegen`). Het project is zichtbaar voor het hele team; besloten maken doet de gebruiker in Boldcaster.

POST/api/v1/project-aanmaken
Parameters
org_iduuidverplicht
Uit de tool `organisaties`.
titelstringverplicht
De naam van het project.
eigenaar_user_iduuidverplicht
Uit de tool `team`.
deadlinestringoptioneel
Datum als JJJJ-MM-DD. Leeg is geen einddatum.
omschrijvingstringoptioneel
Waar het project over gaat.
bevestigcodestringoptioneel
Leeg bij de eerste aanroep. Daarna de code uit het voorstel, na een ja van de gebruiker.

Als het misgaat

Elk antwoord dat geen 200 is bevat een `fout` met een van deze codes, en een melding in gewone taal. De code is stabiel; ga daarop programmeren en niet op de tekst.

401geen_sleutelGeen sleutel meegestuurd, of hij ziet er niet uit als een sleutel van ons.
401sleutel_ingetrokkenDe sleutel bestond, maar is ingetrokken in Boldcaster.
403verkeerde_organisatieDe org_id is een andere dan waar deze sleutel voor is aangemaakt.
403koppeling_uitDe schakelaar van deze deur staat uit voor die organisatie.
403onderdeel_uitDit onderdeel is niet vrijgegeven. Een owner vinkt het aan.
403rol_mag_nietJouw rol in die organisatie mag dit onderdeel niet zien, of de module staat uit.
403alleen_lezenDe koppeling staat op alleen lezen, en dit endpoint schrijft.
400ongeldige_parametersEen parameter ontbreekt, heeft de verkeerde vorm, of bestaat niet. De melding noemt welke.
404onbekend_endpointDat adres bestaat niet. Vraag de index op voor de lijst.

Mis je iets?

Zoek je een gegeven dat er niet in staat, of wil je koppelen met een systeem dat we nog niet kennen? Laat het ons weten. We bouwen verder aan wat mensen echt gebruiken.

Stuur ons een bericht →