REST API

Up/Actions is API-first: dezelfde REST API die de web-app gebruikt, staat open voor je eigen tools. De CLI en de MCP-server draaien er bovenop. API-sleutels zitten in Premium.

Authenticatie

Elke call gaat met een Bearer-token in de Authorization-header:

curl https://actions.upscailed.nl/api/actions?view=today \
  -H "Authorization: Bearer ff_xxx"

Maak sleutels aan op /instellingen/api-sleutels. Een sleutel is aan één workspace gebonden of aan alle workspaces (all).

Scopes

Elke sleutel heeft scopes; elke service-functie checkt de juiste scope (least-privilege):

actions:read, actions:write, actions:complete, actions:assign, actions:delete, workspaces:read, workspaces:write, ai:execute, webhooks:manage.

Geef een agent niet meer dan nodig, bijvoorbeeld een read-only sleutel voor monitoring.

Endpoints

GET    /api/actions?view=today        lijst (view + filters)
POST   /api/actions                   actie aanmaken
GET    /api/actions/{id}              één actie
PATCH  /api/actions/{id}              velden wijzigen
DELETE /api/actions/{id}              verwijderen
POST   /api/actions/{id}/complete     afvinken
POST   /api/actions/{id}/reopen       heropenen
GET    /api/actions/{id}/subtasks     subtaken
POST   /api/actions/resolve           korte-id-prefix → volledige actie(s)
GET    /api/workspaces                workspaces
POST   /api/workspaces                workspace aanmaken
GET    /api/insights                  KPI's / streak / backlog

Views: today, tomorrow, upcoming, overdue, inbox, mine, unassigned, without-deadline, waiting, delegated, archive, all.

Voorbeelden

# Actie aanmaken
curl -X POST https://actions.upscailed.nl/api/actions \
  -H "Authorization: Bearer ff_xxx" \
  -H "Content-Type: application/json" \
  -d '{"title":"Contract nakijken","priority":"high","dueDate":"2026-07-20","workspaceId":"ws_..."}'

# Afvinken
curl -X POST https://actions.upscailed.nl/api/actions/ACTIE_ID/complete \
  -H "Authorization: Bearer ff_xxx"

Een all-sleutel kan cross-workspace schrijven door workspaceId in de body mee te geven.

Liever een commando?

Voor dagelijks gebruik en agents is de CLI prettiger dan losse curl-calls; die wrapt precies deze endpoints.