Chat with Jurre
← All integrations
For developers

Connecting Boldcaster to your own systems

Everything Boldcaster offers to the outside world is on this page. The list below comes straight from the connection itself, so it never lags behind what is actually running.

Before you start

There are two doors to the same data: the AI connection for an assistant, and the REST API for everything else. Each has its own switch, because permission for one is not permission for the other. Beyond that the same three conditions apply to both, and when something fails the answer says which of the three it was.

  1. 1The connection is on for that organisation. An owner turns it on under Integrations, per door.
  2. 2The section is released. Per section an owner chooses whether it may come along: KPIs, priorities, weekly tasks, team, reviews and finance.
  3. 3You are allowed to see it yourself. You work with your own account, so you get exactly the rights you have in Boldcaster, no others. An API key acts as the person who created it and sees no more than they do.

Every call is written to the organisation's log, including refused ones. That is deliberate: a connection that reads along should be visible to whoever switched it on.

The AI connection (MCP)

Claude, ChatGPT and Vibe speak this protocol. Add the address as a connector and sign in with your Boldcaster account.

https://boldcaster.com/mcp

Step by step per app is on the AI connection page.

The REST API

For anything that isn't an AI assistant: Power BI, a script, or your client's data warehouse. The same data and the same rights as above, in plain JSON.

https://boldcaster.com/api/v1

An owner creates a key under Integrations, at API keys. It goes in the Authorization header; a key is valid for one organisation.

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

Request the address above without a key and you get the list of endpoints back, with their parameters.

To check a key, make one call: 200 with a valid key, 401 without. This is also the address Zapier and Make use to verify a key someone entered. https://boldcaster.com/api/v1/wie-ben-ik

Webhooks

With a webhook, Boldcaster sends a message to your address as soon as something happens. The owner of the organisation creates it in the app, under Integrations at Webhooks. You do not need an API key for it. These are the events:

  • taak.aangemaakt A task is added under a priority, in a project or as a loose task.
  • taak.gewijzigd The title, deadline, owner or status of a task changes, or a completed task is reopened.
  • taak.klaar Someone ticks off a task.
  • prioriteit.aangemaakt A rock or OKR is added.
  • prioriteit.afgerond A rock or OKR is completed.
  • kpi.rood A measurement comes out red against the quarterly target.
  • reflectie.ingediend Someone submits a monthly, quarterly or annual reflection. Only who and which period, not the content.

Every message is a POST with JSON. The header says which event it is, the content sits under 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" }
  }
}

Verify the signature before you act on a message. It is an HMAC-SHA256 over the timestamp, a full stop and the raw body, using the signing secret you received when you created the webhook.

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));
}

Respond with a 2xx within ten seconds. If that fails we retry after 1 minute, 5 minutes, 30 minutes, 2 hours and 12 hours. A message can therefore arrive twice: use the id to recognise duplicates. After fifteen failed messages in a row we switch the webhook off and the owner gets a notification.

Tasks from a private project are not sent, and neither are descriptions, notes or the content of a reflection. Fetch anything else you need through the REST API. The address must be https, use a domain name and must not redirect.

What you can request

These change nothing. They return the same figures and traffic lights as the screens in Boldcaster, computed by the same 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.

Only via the AI connection. An API key is already scoped to one organisation, so there is nothing to choose.
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_iduuidrequired
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_iduuidrequired
Uit de tool `organisaties`.
kwartaalstringoptional
Bijvoorbeeld "Q3-2026". Leeg is het lopende kwartaal.
alleen_aandachtja/neeoptional
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_iduuidrequired
Uit de tool `organisaties`.
kwartaalstringoptional
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_iduuidrequired
Uit de tool `organisaties`.
weekstringoptional
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_iduuidrequired
Uit de tool `organisaties`.
aantalgeheel getaloptional
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_iduuidrequired
Uit de tool `organisaties`.
jaargeheel getaloptional
Alleen de gesprekken van dit jaar. Leeg is alle jaren.
alleen_openja/neeoptional
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_iduuidrequired
Uit de tool `organisaties`.
aantalgeheel getaloptional
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_iduuidrequired
Uit de tool `organisaties`.
soortkeuzeoptional
Alleen taken onder prioriteiten, in projecten, of de losse taken. Leeg is alles.
Options: prioriteit, project, los
hoort_bij_iduuidoptional
De id van één prioriteit (uit `prioriteiten`) of één project (uit `projecten`).
eigenaar_user_iduuidoptional
Uit de tool `team`.
ook_afgeslotenja/neeoptional
Ook taken die klaar of vervallen zijn. Standaard alleen wat open staat.
nummergeheel getaloptional
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_iduuidrequired
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_iduuidrequired
Uit de tool `organisaties`.
soortkeuzerequired
Maandreflectie of kwartaalreflectie.
Options: maand, kwartaal
periodestringoptional
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_iduuidrequired
Uit de tool `organisaties`.
vanstringoptional
Eerste dag van de periode, als JJJJ-MM-DD. Leeg is de eerste van deze maand.
totstringoptional
Laatste dag van de periode, als JJJJ-MM-DD. Leeg is de laatste van deze maand.
user_iduuidoptional
Alleen de uren van deze persoon, uit de tool `team`. Leeg is iedereen.

What you can record

These do write. They only work when the organisation is not set to read only, and should run after an explicit yes from the user.

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_iduuidrequired
Uit de tool `organisaties`.
titelstringrequired
Kort en als uitkomst geformuleerd.
soortkeuzerequired
Rock of OKR. Geen standaard: kies bewust.
Options: rock, okr
eigenaar_user_iduuidrequired
Uit de tool `team`.
kwartaalstringoptional
Bijvoorbeeld "Q4-2026". Leeg is het lopende kwartaal.
deadlinestringoptional
Datum als JJJJ-MM-DD. Leeg is het einde van het kwartaal.
omschrijvingstringoptional
Waarom deze prioriteit, en wanneer is hij af.
bevestigcodestringoptional
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_iduuidrequired
Uit de tool `organisaties`.
kpi_iduuidrequired
Uit de tool `kpi_scorebord`.
waardegetalrequired
De gemeten waarde in de eenheid van de KPI.
periodestringoptional
"2026-W40" bij een week-KPI, "2026-09" bij een maand-KPI. Leeg is de lopende periode.
toelichtingstringoptional
Verplicht als de KPI oranje of rood wordt.
bevestigcodestringoptional
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_iduuidrequired
Uit de tool `organisaties`.
prioriteit_iduuidoptional
De id van de rock of OKR, uit `prioriteiten`. Niet samen met project_id.
project_iduuidoptional
De id van het project, uit `projecten`. Niet samen met prioriteit_id.
onder_taak_nummergeheel getaloptional
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.
omschrijvingstringrequired
De taak, kort en als handeling: wie doet wat.
eigenaar_user_iduuidoptional
Uit de tool `team`. Leeg is niemand.
deadlinestringoptional
Datum als JJJJ-MM-DD. Leeg is geen deadline.
herhalenkeuzeoptional
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.
Options: dag, week, maand, kwartaal, jaar
groottekeuzeoptional
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.
Options: klein, middel, groot
inschatting_urengetaloptional
De inschatting in uren, als je het preciezer weet dan een grootte.
bevestigcodestringoptional
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_iduuidrequired
Uit de tool `organisaties`.
naamstringrequired
Hoe de KPI op het scorebord heet.
eenheidstringoptional
Bijvoorbeeld "EUR", "%", "stuks".
eigenaar_user_iduuidrequired
Uit de tool `team`. Elke KPI heeft één eigenaar.
meetsoortkeuzerequired
Teller telt op, stand is een momentopname.
Options: teller, stand
cadanskeuzerequired
Wordt hij per week of per maand ingevuld?
Options: week, month
lager_is_beterja/neeoptional
Waar bij churn, kosten of doorlooptijd. Standaard nee.
bevestigcodestringoptional
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_iduuidrequired
Uit de tool `organisaties`.
veldenobjectrequired
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_iduuidrequired
Uit de tool `organisaties`.
titelstringrequired
De taak, kort: wat moet er gebeuren.
weekstringoptional
ISO-week, bijvoorbeeld "2026-W41". Leeg is deze week.
voor_user_iduuidoptional
Uit de tool `team`. Leeg is de gebruiker zelf.
prioriteit_iduuidoptional
De rock of OKR waar hij bij hoort.
bevestigcodestringoptional
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_iduuidrequired
Uit de tool `organisaties`.
datumstringoptional
JJJJ-MM-DD. Leeg is vandaag.
prioriteit_1stringoptional
De belangrijkste van de dag.
prioriteit_2stringoptional
De tweede.
prioriteit_3stringoptional
De derde.
bevestigcodestringoptional
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_iduuidrequired
Uit de tool `organisaties`.
datumstringrequired
De datum van de sessie als JJJJ-MM-DD.
titelstringrequired
Korte titel, zoals 'Kwartaalsessie Q4'.
soortkeuzerequired
Het soort sessie.
Options: strategie, kwartaal, maand, check_in, overig
samenvattingstringrequired
Wat er is besproken, in gewone zinnen.
highlightsarrayoptional
De belangrijkste punten, één per regel.
besluitenarrayoptional
Wat er is besloten.
learningsarrayoptional
Wat het team heeft geleerd.
actiepuntenarrayoptional
De actiepunten uit de sessie.
bevestigcodestringoptional
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_iduuidrequired
Uit de tool `organisaties`.
taak_iduuidrequired
De id van de taak, uit `taken`.
standkeuzeoptional
De nieuwe stand.
Options: open, in_uitvoering, wacht_op_feedback, voltooid, vervallen
eigenaar_user_idtekstoptional
Uit de tool `team`. null haalt de eigenaar eraf.
deadlinetekstoptional
Datum als JJJJ-MM-DD. null haalt de deadline eraf.
herhalenkeuzeoptional
Hoe vaak de taak terugkomt. "niet" zet herhalen uit.
Options: niet, dag, week, maand, kwartaal, jaar
omschrijvingstringoptional
De nieuwe tekst.
groottekeuzeoptional
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.
Options: klein, middel, groot
inschatting_urentekstoptional
De inschatting in uren. null haalt hem eraf.
bevestigcodestringoptional
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_iduuidrequired
Uit de tool `organisaties`.
titelstringrequired
De naam van het project.
eigenaar_user_iduuidrequired
Uit de tool `team`.
deadlinestringoptional
Datum als JJJJ-MM-DD. Leeg is geen einddatum.
omschrijvingstringoptional
Waar het project over gaat.
bevestigcodestringoptional
Leeg bij de eerste aanroep. Daarna de code uit het voorstel, na een ja van de gebruiker.

When it fails

Every answer that isn't a 200 contains a `fout` with one of these codes, plus a message in plain language. The code is stable; build against that, not against the text.

401geen_sleutelNo key sent, or it doesn't look like one of ours.
401sleutel_ingetrokkenThe key existed but has been revoked in Boldcaster.
403verkeerde_organisatieThe org_id differs from the one this key was created for.
403koppeling_uitThe switch for this door is off for that organisation.
403onderdeel_uitThis section has not been released. An owner ticks it.
403rol_mag_nietYour role in that organisation may not see this section, or the module is off.
403alleen_lezenThe connection is read only, and this endpoint writes.
400ongeldige_parametersA parameter is missing, has the wrong shape, or doesn't exist. The message says which.
404onbekend_endpointThat address doesn't exist. Request the index for the list.

Missing something?

Looking for data that isn't in here, or want to connect a system we don't support yet? Let us know. We build on what people actually use.

Send us a message →