REST API-referentie en webhooks - Todo4you Developers

Authenticatie

Elk verzoek moet je persoonlijke API token bevatten als Bearer token in de Authorization header. Er zijn geen andere authenticatiemethoden.

1 - Je token ophalen

Log in op Todo4you, ga naar Profiel - API-toegang en klik op Token genereren. Je token is een hexadecimale reeks van 64 tekens. Kopieer deze direct - het wordt slechts een keer getoond.

Profiel → API-toegang

2 - Voeg de header toe

Authorization: Bearer YOUR_64_CHAR_TOKEN

3 - Test je token

Plak je token hieronder om te verifieren dat het werkt en bekijk je projectlijst:

API token

Fouten

Alle fouten retourneren JSON met een error-veld dat het probleem beschrijft. Succesvolle antwoorden bevatten nooit een error-veld.

// 422 example { "error": "title is required." }

Status	Betekenis
401	Missing or invalid API token
403	Token valid but role insufficient for this action (viewer trying to create/move)
404	Project or ticket not found, or not accessible with your token
422	Validation failed - read the `error` message for the exact field

Projecten

Projecten weergeven

GET /api/v1/projects

Geeft alle projecten terug waar de geauthenticeerde gebruiker eigenaar of lid van is, alfabetisch gesorteerd. Gebruik het id-veld voor alle volgende verzoeken die een project-ID vereisen. Het role-veld is de rol van de aanroepende gebruiker op het project (manager, editor, contributor of viewer) en docs_enabled geeft aan of het documentatie-gedeelte aan staat voor het project.

Antwoord

200 OK200

{ "projects": [ { "id": 12, "name": "My Project", "prefix": "TDL", "description": "Main development board", "role": "manager", "docs_enabled": true } ] }

Voorbeeld

curl https://api.todo4you.com/api/v1/projects \ -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch('https://api.todo4you.com/api/v1/projects', { headers: { Authorization: `Bearer ${TOKEN}` }, }); const { projects } = await res.json();

$ch = curl_init('https://api.todo4you.com/api/v1/projects'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch); $projects = $data['projects'];

import requests data = requests.get( 'https://api.todo4you.com/api/v1/projects', headers={'Authorization': f'Bearer {TOKEN}'}, ).json()

Project aanmaken

POST /api/v1/projects

Maakt een nieuw project aan. Je wordt automatisch de projecteigenaar met de rol manager.

Request body (JSON)

Veld	Type		Beschrijving
name	string	verplicht	Project name (min 2 characters)
prefix	string	optioneel	Ticket prefix, e.g. `TDL`. Alphanumeric only, auto-uppercased
description	string	optioneel	Short project description

Antwoord

201 Created201

{ "project": { "id": 25, "name": "My New Project", "prefix": "MNP", "description": "A fresh project" } }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"name":"My New Project","prefix":"MNP","description":"A fresh project"}'

const { project } = await (await fetch( 'https://api.todo4you.com/api/v1/projects', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ name: 'My New Project', prefix: 'MNP' }), }, )).json();

$payload = json_encode(['name' => 'My New Project', 'prefix' => 'MNP']); $ch = curl_init('https://api.todo4you.com/api/v1/projects'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch); $project = $data['project'];

import requests resp = requests.post( 'https://api.todo4you.com/api/v1/projects', headers={'Authorization': f'Bearer {TOKEN}'}, json={'name': 'My New Project', 'prefix': 'MNP'}, ) project = resp.json()['project']

Projectstatistieken

GET /api/v1/projects/{id}/stats

Geeft het aantal open tickets in een project terug (alle statussen behalve done). Handig voor conditiecontroles en dashboards.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID - from List projects

Antwoord

200 OK200

{ "open_tickets": 14 }

Voorbeeld

curl https://api.todo4you.com/api/v1/projects/12/stats \ -H "Authorization: Bearer YOUR_TOKEN"

const { open_tickets } = await (await fetch( 'https://api.todo4you.com/api/v1/projects/12/stats', { headers: { Authorization: `Bearer ${TOKEN}` } }, )).json();

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/stats'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch); $openTickets = $data['open_tickets'];

import requests data = requests.get( 'https://api.todo4you.com/api/v1/projects/12/stats', headers={'Authorization': f'Bearer {TOKEN}'}, ).json() open_tickets = data['open_tickets']

Projectstatussen

GET /api/v1/projects/{id}/statuses

Geeft de geldige statuswaarden voor een project terug. Geef een van deze door aan Ticket verplaatsen.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID

Antwoord

200 OK200

{ "statuses": [ { "slug": "backlog", "label": "Backlog", "color": "#6c757d", "icon": "fa-inbox", "category": "backlog" }, { "slug": "todo", "label": "To Do", "color": "#0dcaf0", "icon": "fa-list-ul", "category": "todo" }, { "slug": "in_progress", "label": "In Progress", "color": "#ffc107", "icon": "fa-tasks", "category": "active" }, { "slug": "review", "label": "Review", "color": "#0d6efd", "icon": "fa-eye", "category": "review" }, { "slug": "done", "label": "Done", "color": "#198754", "icon": "fa-check-circle", "category": "done" } ] }

Voorbeeld

curl https://api.todo4you.com/api/v1/projects/12/statuses \ -H "Authorization: Bearer YOUR_TOKEN"

const { statuses } = await (await fetch( 'https://api.todo4you.com/api/v1/projects/12/statuses', { headers: { Authorization: `Bearer ${TOKEN}` } }, )).json();

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/statuses'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch); $statuses = $data['statuses'];

import requests data = requests.get( 'https://api.todo4you.com/api/v1/projects/12/statuses', headers={'Authorization': f'Bearer {TOKEN}'}, ).json() statuses = data['statuses']

Leden weergeven

GET /api/v1/projects/{id}/members

Geeft alle leden van een project terug met hun rollen. Gebruik de id-waarden bij het toewijzen van tickets via Lid toewijzen.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID

Antwoord

200 OK200

{ "members": [ { "id": 3, "name": "Alice", "avatar": null, "role": "manager" }, { "id": 8, "name": "Bob", "avatar": null, "role": "developer" } ] }

Voorbeeld

curl https://api.todo4you.com/api/v1/projects/12/members \ -H "Authorization: Bearer YOUR_TOKEN"

const { members } = await (await fetch( 'https://api.todo4you.com/api/v1/projects/12/members', { headers: { Authorization: `Bearer ${TOKEN}` } }, )).json();

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/members'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch); $members = $data['members'];

import requests data = requests.get( 'https://api.todo4you.com/api/v1/projects/12/members', headers={'Authorization': f'Bearer {TOKEN}'}, ).json() members = data['members']

Tickets

Tickets weergeven

GET /api/v1/projects/{id}/tickets

Geeft alle niet-gearchiveerde tickets in een project terug. Optioneel filteren op statuskolom. Elk ticket bevat de tags en een prefix_ref-veld (bijv. TDL-47).

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID

Queryparameters

Parameter	Type		Beschrijving
status	string	optioneel	Filter by status slug (use `GET /projects/{id}/statuses` to get valid slugs)

Antwoord

200 OK200

{ "tickets": [ { "id": 301, "project_ticket_number": 47, "prefix_ref": "TDL-47", "title": "Fix login bug", "status": "in_progress", "type": "bug", "priority": "high", "deadline": "2026-03-15", "tags": [ { "id": 5, "name": "frontend", "color": "#e74c3c" } ], "created_at": "2026-03-01 14:22:00" } ] }

Voorbeeld

curl https://api.todo4you.com/api/v1/projects/12/tickets?status=in_progress \ -H "Authorization: Bearer YOUR_TOKEN"

const { tickets } = await (await fetch( 'https://api.todo4you.com/api/v1/projects/12/tickets?status=in_progress', { headers: { Authorization: `Bearer ${TOKEN}` } }, )).json();

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tickets?status=in_progress'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch); $tickets = $data['tickets'];

import requests data = requests.get( 'https://api.todo4you.com/api/v1/projects/12/tickets', headers={'Authorization': f'Bearer {TOKEN}'}, params={'status': 'in_progress'}, ).json() tickets = data['tickets']

Ticket ophalen

GET /api/v1/projects/{id}/tickets/{number}

Geeft volledige ticketdetails terug inclusief reacties, checklist-items, tags, toegewezen personen en maker. Het number is het ticketnummer binnen het project - het numerieke deel van een referentie zoals TDL-47.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID
number	integer	Ticket number within the project (e.g. `47` for `TDL-47`)

Antwoord

200 OK200

{ "ticket": { "id": 301, "prefix_ref": "TDL-47", "title": "Fix login bug", "status": "in_progress", "type": "bug", "priority": "high", "deadline": "2026-03-15", "tags": [ { "id": 5, "name": "frontend", "color": "#e74c3c" } ], "comments": [ { "id": 291, "message": "Found the root cause", "user_id": 8, "user_name": "Alice", "created_at": "2026-03-02 09:15:00" } ], "checklist": [ { "id": 10, "text": "Write tests", "done": 0 }, { "id": 11, "text": "Update docs", "done": 1 } ], "assignees": [ { "id": 8, "name": "Alice" } ], "creator": { "id": 3, "name": "Bob" } } }

Voorbeeld

curl https://api.todo4you.com/api/v1/projects/12/tickets/47 \ -H "Authorization: Bearer YOUR_TOKEN"

const { ticket } = await (await fetch( 'https://api.todo4you.com/api/v1/projects/12/tickets/47', { headers: { Authorization: `Bearer ${TOKEN}` } }, )).json();

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tickets/47'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch); $ticket = $data['ticket'];

import requests data = requests.get( 'https://api.todo4you.com/api/v1/projects/12/tickets/47', headers={'Authorization': f'Bearer {TOKEN}'}, ).json() ticket = data['ticket']

Tickets zoeken

GET /api/v1/projects/{id}/tickets/search?q={query}

Zoekt niet-gearchiveerde tickets op trefwoord. Vergelijkt met de tickettitel en beschrijving (niet hoofdlettergevoelig). Geeft resultaten terug gesorteerd op meest recent bijgewerkt.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID

Queryparameters

Parameter	Type		Beschrijving
q	string	verplicht	Search keyword(s) to match against title and description

Antwoord

200 OK200

{ "tickets": [ { "id": 301, "project_ticket_number": 47, "prefix_ref": "TDL-47", "title": "Fix login bug", "status": "in_progress", "type": "bug", "tags": [ { "id": 5, "name": "frontend", "color": "#e74c3c" } ] } ] }

Voorbeeld

curl "https://api.todo4you.com/api/v1/projects/12/tickets/search?q=login" \ -H "Authorization: Bearer YOUR_TOKEN"

const { tickets } = await (await fetch( `https://api.todo4you.com/api/v1/projects/12/tickets/search?q=${encodeURIComponent('login')}`, { headers: { Authorization: `Bearer ${TOKEN}` } }, )).json();

$q = urlencode('login'); $ch = curl_init("https://api.todo4you.com/api/v1/projects/12/tickets/search?q={$q}"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch); $tickets = $data['tickets'];

import requests data = requests.get( 'https://api.todo4you.com/api/v1/projects/12/tickets/search', headers={'Authorization': f'Bearer {TOKEN}'}, params={'q': 'login'}, ).json() tickets = data['tickets']

Tickets

Ticket aanmaken

POST /api/v1/projects/{id}/tickets

Maakt een nieuw ticket aan in een project en retourneert de referentie (bijv. TDL-47). Standaard in de backlog-kolom, tenzij een status is opgegeven. Vereist de rol editor of manager in het project.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID

Request body (JSON)

Veld	Type		Beschrijving
title	string	verplicht	Ticket title
type	string	optioneel	`bug` - `feature` - `release` Default: `feature`
priority	string	optioneel	`urgent` - `high` - `medium` - `low` Default: none
status	string	optioneel	Status slug (use Project statuses to get valid slugs) Default: first status in project
deadline	string	optioneel	Date in `YYYY-MM-DD` format
story_points	integer	optioneel	`0` - `3`. Only accepted when the project uses story points estimation
estimated_hours	number	optioneel	Estimated hours (e.g. `4.5`). Only accepted when the project uses hours estimation
checklist	string[]	optioneel	Array of checklist item texts, e.g. `["Write tests", "Update docs"]`
tags	integer[]	optioneel	Array of tag IDs from List tags

Antwoord

201 Created201

{ "ticket_ref": "TDL-47" }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/tickets \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "Fix login bug", "type": "bug", "priority": "high", "status": "todo", "deadline": "2026-03-15", "checklist": ["Write tests", "Update docs"], "tags": [5, 12] }'

const { ticket_ref } = await (await fetch( 'https://api.todo4you.com/api/v1/projects/12/tickets', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ title: 'Fix login bug', type: 'bug', priority: 'high', status: 'todo', deadline: '2026-03-15', checklist: ['Write tests', 'Update docs'], tags: [5, 12], }), }, )).json(); // ticket_ref -> "TDL-47"

$payload = json_encode([ 'title' => 'Fix login bug', 'type' => 'bug', 'priority' => 'high', 'status' => 'todo', 'deadline' => '2026-03-15', 'checklist' => ['Write tests', 'Update docs'], 'tags' => [5, 12], ]); $ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tickets'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch); $ticketRef = $data['ticket_ref']; // "TDL-47"

import requests resp = requests.post( 'https://api.todo4you.com/api/v1/projects/12/tickets', headers={'Authorization': f'Bearer {TOKEN}'}, json={ 'title': 'Fix login bug', 'type': 'bug', 'priority': 'high', 'status': 'todo', 'deadline': '2026-03-15', 'checklist': ['Write tests', 'Update docs'], 'tags': [5, 12], }, ) ticket_ref = resp.json()['ticket_ref'] # "TDL-47"

Ticket bijwerken

POST /api/v1/projects/{id}/tickets/{number}/update

Werkt een of meer velden van een ticket bij. Stuur alleen de velden die je wilt wijzigen. Vereist de rol editor of manager. Om de statuskolom te wijzigen, gebruik Ticket verplaatsen in plaats daarvan.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID
number	integer	Ticket number within the project

Request body (JSON)

Veld	Type		Beschrijving
title	string	optioneel	New title (cannot be empty)
description	string	optioneel	New description (empty string to clear)
type	string	optioneel	`bug` - `feature` - `release`
priority	string\|null	optioneel	`urgent` - `high` - `medium` - `low` - `null` to clear
deadline	string\|null	optioneel	`YYYY-MM-DD` or `null` to clear
story_points	integer\|null	optioneel	`0`-`3` or `null` to clear (story points mode only)
estimated_hours	number\|null	optioneel	Hours or `null` to clear (hours mode only)
tags	integer[]	optioneel	Replace all tags with this list of tag IDs

Antwoord

200 OK200

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/tickets/47/update \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"title":"Updated title","priority":"urgent","tags":[5,12]}'

await fetch('https://api.todo4you.com/api/v1/projects/12/tickets/47/update', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ title: 'Updated title', priority: 'urgent', tags: [5, 12] }), });

$payload = json_encode(['title' => 'Updated title', 'priority' => 'urgent']); $ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tickets/47/update'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests requests.post( 'https://api.todo4you.com/api/v1/projects/12/tickets/47/update', headers={'Authorization': f'Bearer {TOKEN}'}, json={'title': 'Updated title', 'priority': 'urgent'}, )

Reactie toevoegen

POST /api/v1/projects/{id}/tickets/{number}/comments

Plaatst een reactie op een ticket. Elk projectlid kan reageren. Het number is het ticketnummer binnen het project - het numerieke deel van een referentie zoals TDL-47.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID
number	integer	Ticket number within the project (e.g. `47` for `TDL-47`)

Request body (JSON)

Veld	Type		Beschrijving
comment	string	verplicht	Comment text

Antwoord

201 Created201

{ "ok": true, "reaction_id": 291 }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/tickets/47/comments \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"comment":"Triggered by Homey at 08:32"}'

await fetch('https://api.todo4you.com/api/v1/projects/12/tickets/47/comments', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ comment: 'Triggered by Homey at 08:32' }), });

$payload = json_encode(['comment' => 'Triggered by Homey at 08:32']); $ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tickets/47/comments'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); // ['ok' => true, 'reaction_id' => 291] curl_close($ch);

import requests requests.post( 'https://api.todo4you.com/api/v1/projects/12/tickets/47/comments', headers={'Authorization': f'Bearer {TOKEN}'}, json={'comment': 'Triggered by Homey at 08:32'}, )

Ticket verplaatsen

POST /api/v1/projects/{id}/tickets/{number}/move

Verplaatst een ticket naar een andere statuskolom. Triggert een realtime boardupdate voor alle actieve kijkers. Vereist de rol editor of manager.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID
number	integer	Ticket number within the project

Request body (JSON)

Veld	Type		Beschrijving
status	string	verplicht	Status slug (use Project statuses to get valid slugs)

Antwoord

200 OK200

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/tickets/47/move \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"status":"done"}'

await fetch('https://api.todo4you.com/api/v1/projects/12/tickets/47/move', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ status: 'done' }), });

$payload = json_encode(['status' => 'done']); $ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tickets/47/move'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); // ['ok' => true] curl_close($ch);

import requests requests.post( 'https://api.todo4you.com/api/v1/projects/12/tickets/47/move', headers={'Authorization': f'Bearer {TOKEN}'}, json={'status': 'done'}, )

Ticket archiveren

POST /api/v1/projects/{id}/tickets/{number}/archive

Archiveert een ticket en verwijdert het van het actieve board. Gearchiveerde tickets kunnen worden hersteld vanaf de projectarchiefpagina. Vereist de rol editor of beheerder.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID
number	integer	Ticket number within the project

Antwoord

200 OK200

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/tickets/47/archive \ -H "Authorization: Bearer YOUR_TOKEN"

await fetch('https://api.todo4you.com/api/v1/projects/12/tickets/47/archive', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}` }, });

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tickets/47/archive'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); // ['ok' => true] curl_close($ch);

import requests requests.post( 'https://api.todo4you.com/api/v1/projects/12/tickets/47/archive', headers={'Authorization': f'Bearer {TOKEN}'}, )

Ticket uit archief halen

POST /api/v1/projects/{id}/tickets/{number}/unarchive

Herstelt een eerder gearchiveerd ticket terug op het bord. Geeft het volledige ticket terug (met aanmaker, toegewezenen, tags en checklisttellingen) zodat de client direct kan vernieuwen. Vereist manager-rol.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID
number	integer	Ticket number within the project

Antwoord

200 OK200

{ "ok": true, "ticket": { "id": 312, "project_ticket_number": 47, "prefix_ref": "TDL-47", "title": "Set up CI", "status": "in_progress", "archived_at": null } }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/tickets/47/unarchive \ -H "Authorization: Bearer YOUR_TOKEN"

await fetch('https://api.todo4you.com/api/v1/projects/12/tickets/47/unarchive', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}` }, });

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tickets/47/unarchive'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests requests.post( 'https://api.todo4you.com/api/v1/projects/12/tickets/47/unarchive', headers={'Authorization': f'Bearer {TOKEN}'}, )

Gearchiveerde tickets opvragen

GET /api/v1/projects/{id}/archived-tickets

Geeft maximaal 100 recent gearchiveerde tickets in een project terug, nieuwste eerst. Optioneel filteren op titel met de q queryparameter (minimaal 2 tekens). Het antwoord bevat ook de role van de aanroepende gebruiker op dit project, zodat een client kan bepalen of Herstellen (managers) en Verwijderen (managers of ticketmaker) zichtbaar zijn. Vereist viewer-rol.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID

Queryparameters

Parameter	Type	Beschrijving
q	string	Optionele zoekopdracht op titel, niet hoofdlettergevoelig. Minimaal 2 tekens.

Antwoord

200 OK200

{ "success": true, "role": "manager", "tickets": [ { "id": 312, "project_id": 12, "project_ticket_number": 47, "prefix_ref": "TDL-47", "title": "Set up CI", "type": "feature", "status": "done", "priority": "medium", "deadline": null, "story_points": 2, "estimated_hours": null, "sort_order": 0, "archived_at": "2026-04-19 14:32:11", "created_by": 7 } ] }

Voorbeeld

curl "https://api.todo4you.com/api/v1/projects/12/archived-tickets?q=ci" \ -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch('https://api.todo4you.com/api/v1/projects/12/archived-tickets?q=ci', { headers: { Authorization: `Bearer ${TOKEN}` }, }); const { tickets, role } = await res.json();

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/archived-tickets?q=ci'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests res = requests.get( 'https://api.todo4you.com/api/v1/projects/12/archived-tickets', params={'q': 'ci'}, headers={'Authorization': f'Bearer {TOKEN}'}, ) data = res.json()

Ticket verwijderen

POST /api/v1/projects/{id}/tickets/{number}/delete

Verwijdert een ticket permanent (soft delete). De maker van het ticket kan eigen tickets verwijderen; anders is de manager-rol vereist.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID
number	integer	Ticket number within the project

Antwoord

200 OK200

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/tickets/47/delete \ -H "Authorization: Bearer YOUR_TOKEN"

await fetch('https://api.todo4you.com/api/v1/projects/12/tickets/47/delete', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}` }, });

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tickets/47/delete'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests requests.post( 'https://api.todo4you.com/api/v1/projects/12/tickets/47/delete', headers={'Authorization': f'Bearer {TOKEN}'}, )

Lid toewijzen

POST /api/v1/projects/{id}/tickets/{number}/assign

Wijst een projectlid toe aan een ticket. De gebruiker moet lid zijn van het project. Gebruik Leden weergeven om geldige gebruikers-ID's te vinden. Vereist de rol editor of manager.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID
number	integer	Ticket number within the project

Request body (JSON)

Veld	Type		Beschrijving
user_id	integer	verplicht	The project member's user ID

Antwoord

201 Created201

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/tickets/47/assign \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"user_id":8}'

await fetch('https://api.todo4you.com/api/v1/projects/12/tickets/47/assign', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ user_id: 8 }), });

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tickets/47/assign'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode(['user_id' => 8]), CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests requests.post( 'https://api.todo4you.com/api/v1/projects/12/tickets/47/assign', headers={'Authorization': f'Bearer {TOKEN}'}, json={'user_id': 8}, )

Toewijzing lid opheffen

POST /api/v1/projects/{id}/tickets/{number}/unassign

Verwijdert een lid van de toegewezen-lijst. Vereist de rol editor of manager

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID
number	integer	Ticket number within the project

Request body (JSON)

Veld	Type		Beschrijving
user_id	integer	verplicht	The user ID to unassign

Antwoord

200 OK200

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/tickets/47/unassign \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"user_id":8}'

await fetch('https://api.todo4you.com/api/v1/projects/12/tickets/47/unassign', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ user_id: 8 }), });

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tickets/47/unassign'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode(['user_id' => 8]), CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests requests.post( 'https://api.todo4you.com/api/v1/projects/12/tickets/47/unassign', headers={'Authorization': f'Bearer {TOKEN}'}, json={'user_id': 8}, )

Board

Boardgegevens

GET /api/v1/projects/{id}/board

Geeft in één keer het volledige kanbanbord voor een project terug: alle kolommen met de bijbehorende tickets, projecttags, leden, snelheid (tickets die in de afgelopen 7 dagen zijn afgehandeld) en de rol van de ingelogde gebruiker. Elk ticket bevat tags, een lijst met toegewezen personen, het aantal reacties, de voortgang van de checklist en informatie over de maker.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID

Antwoord

200 OK200

{ "project": { "id": 12, "name": "My Project", "prefix": "TDL", "estimation_mode": "story_points", "role": "manager", "docs_enabled": true }, "columns": [ { "status": "backlog", "hidden": false, "tickets": [ { "id": 101, "title": "Fix bug", "prefix_ref": "TDL-1", "tags": [...], "assignees": [...], "creator": {...}, "reaction_count": 3, "checklist_total": 5, "checklist_done": 2 } ] }, ... ], "tags": [...], "members": [...], "velocity": 8 }

Voorbeeld

curl https://api.todo4you.com/api/v1/projects/12/board \ -H "Authorization: Bearer YOUR_TOKEN"

const board = await (await fetch( 'https://api.todo4you.com/api/v1/projects/12/board', { headers: { Authorization: `Bearer ${TOKEN}` } }, )).json();

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/board'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch); $board = $data;

import requests board = requests.get( 'https://api.todo4you.com/api/v1/projects/12/board', headers={'Authorization': f'Bearer {TOKEN}'}, ).json()

Tickets sorteren

POST /api/v1/projects/{id}/tickets/sort

Herordent tickets binnen een kolom. Geef de status en de volledige geordende lijst van ticket-ID's door. Vereist de contributor-rol of hoger.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID

Request body (JSON)

Veld	Type		Beschrijving
status	string	verplicht	Column status being reordered
ticket_ids	integer[]	verplicht	Ordered array of ticket IDs

Antwoord

200 OK200

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/tickets/sort \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"status":"todo","ticket_ids":[45,12,78]}'

await fetch('https://api.todo4you.com/api/v1/projects/12/tickets/sort', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ status: 'todo', ticket_ids: [45, 12, 78] }), });

$payload = json_encode(['status' => 'todo', 'ticket_ids' => [45, 12, 78]]); $ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tickets/sort'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests data = requests.post( 'https://api.todo4you.com/api/v1/projects/12/tickets/sort', headers={'Authorization': f'Bearer {TOKEN}'}, json={'status': 'todo', 'ticket_ids': [45, 12, 78]}, ).json()

Checklist

Checklist-item toevoegen

POST /api/v1/tickets/{ticketId}/checklist

Voegt een checklist-item toe aan een ticket. Het item begint als niet-aangevinkt en wordt aan het einde toegevoegd. Vereist de rol editor of beheerder.

Padparameters

Parameter	Type	Beschrijving
ticketId	integer	Ticket ID (not the project ticket number)

Request body (JSON)

Veld	Type		Beschrijving
text	string	verplicht	Item text (max 500 characters)

Antwoord

201 Created201

{ "ok": true, "item": { "id": 42, "ticket_id": 101, "text": "Write tests", "done": 0, "sort_order": 3 } }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/tickets/101/checklist \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"text":"Write tests"}'

await fetch('https://api.todo4you.com/api/v1/tickets/101/checklist', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ text: 'Write tests' }), });

$payload = json_encode(['text' => 'Write tests']); $ch = curl_init('https://api.todo4you.com/api/v1/tickets/101/checklist'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch); $item = $data['item'];

import requests data = requests.post( 'https://api.todo4you.com/api/v1/tickets/101/checklist', headers={'Authorization': f'Bearer {TOKEN}'}, json={'text': 'Write tests'}, ).json() item = data['item']

Checklist-item aan/uit zetten

POST /api/v1/checklist/{itemId}/toggle

Schakelt een checklist-item tussen afgerond en niet afgerond. Vereist de rol editor of manager.

Padparameters

Parameter	Type	Beschrijving
itemId	integer	Checklist item ID

Antwoord

200 OK200

{ "ok": true, "done": 1 }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/checklist/42/toggle \ -H "Authorization: Bearer YOUR_TOKEN"

await fetch('https://api.todo4you.com/api/v1/checklist/42/toggle', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}` }, });

$ch = curl_init('https://api.todo4you.com/api/v1/checklist/42/toggle'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests data = requests.post( 'https://api.todo4you.com/api/v1/checklist/42/toggle', headers={'Authorization': f'Bearer {TOKEN}'}, ).json()

Checklist-item bijwerken

POST /api/v1/checklist/{itemId}/update

Werkt de tekst van een checklist-item bij. Vereist de rol editor of manager.

Padparameters

Parameter	Type	Beschrijving
itemId	integer	Checklist item ID

Request body (JSON)

Veld	Type		Beschrijving
text	string	verplicht	New item text (max 500 characters)

Antwoord

200 OK200

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/checklist/42/update \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"text":"Write integration tests"}'

await fetch('https://api.todo4you.com/api/v1/checklist/42/update', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ text: 'Write integration tests' }), });

$payload = json_encode(['text' => 'Write integration tests']); $ch = curl_init('https://api.todo4you.com/api/v1/checklist/42/update'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests data = requests.post( 'https://api.todo4you.com/api/v1/checklist/42/update', headers={'Authorization': f'Bearer {TOKEN}'}, json={'text': 'Write integration tests'}, ).json()

Checklist-item verwijderen

POST /api/v1/checklist/{itemId}/delete

Verwijdert een checklist-item van een ticket. Vereist de editor- of manager-rol.

Padparameters

Parameter	Type	Beschrijving
itemId	integer	Checklist item ID

Antwoord

200 OK200

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/checklist/42/delete \ -H "Authorization: Bearer YOUR_TOKEN"

await fetch('https://api.todo4you.com/api/v1/checklist/42/delete', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}` }, });

$ch = curl_init('https://api.todo4you.com/api/v1/checklist/42/delete'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests data = requests.post( 'https://api.todo4you.com/api/v1/checklist/42/delete', headers={'Authorization': f'Bearer {TOKEN}'}, ).json()

Checklist-items sorteren

POST /api/v1/tickets/{ticketId}/checklist/sort

Herordent alle checklist-items voor een ticket. Geef de volledige geordende lijst van item-ID's door. Vereist de editor- of manager-rol.

Padparameters

Parameter	Type	Beschrijving
ticketId	integer	Ticket ID

Request body (JSON)

Veld	Type		Beschrijving
item_ids	integer[]	verplicht	Ordered array of checklist item IDs

Antwoord

200 OK200

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/tickets/101/checklist/sort \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"item_ids":[42,43,41]}'

await fetch('https://api.todo4you.com/api/v1/tickets/101/checklist/sort', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ item_ids: [42, 43, 41] }), });

$payload = json_encode(['item_ids' => [42, 43, 41]]); $ch = curl_init('https://api.todo4you.com/api/v1/tickets/101/checklist/sort'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests data = requests.post( 'https://api.todo4you.com/api/v1/tickets/101/checklist/sort', headers={'Authorization': f'Bearer {TOKEN}'}, json={'item_ids': [42, 43, 41]}, ).json()

Blokkades

Blokkade toevoegen

POST /api/v1/tickets/{ticketId}/blockers

Markeert een ander ticket in hetzelfde project als blocker voor dit ticket. Een ticket kan zichzelf niet blokkeren. Vereist de rol editor of manager.

Padparameters

Parameter	Type	Beschrijving
ticketId	integer	Ticket ID of the blocked ticket

Request body (JSON)

Veld	Type		Beschrijving
blocker_ticket_id	integer	verplicht	Ticket ID of the blocking ticket (must be in the same project)

Antwoord

201 Created201

{ "ok": true, "blockers": [ { "id": 55, "title": "Setup database", "status": "in_progress", "project_ticket_number": 3 } ] }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/tickets/101/blockers \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"blocker_ticket_id":55}'

await fetch('https://api.todo4you.com/api/v1/tickets/101/blockers', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ blocker_ticket_id: 55 }), });

$payload = json_encode(['blocker_ticket_id' => 55]); $ch = curl_init('https://api.todo4you.com/api/v1/tickets/101/blockers'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests data = requests.post( 'https://api.todo4you.com/api/v1/tickets/101/blockers', headers={'Authorization': f'Bearer {TOKEN}'}, json={'blocker_ticket_id': 55}, ).json()

Blocker verwijderen

POST /api/v1/tickets/{ticketId}/blockers/{blockerTicketId}/delete

Verwijdert een blocker-relatie van een ticket. Geeft de bijgewerkte blockerlijst terug. Vereist de editor- of manager-rol.

Padparameters

Parameter	Type	Beschrijving
ticketId	integer	Ticket ID of the blocked ticket
blockerTicketId	integer	Ticket ID of the blocker to remove

Antwoord

200 OK200

{ "ok": true, "blockers": [] }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/tickets/101/blockers/55/delete \ -H "Authorization: Bearer YOUR_TOKEN"

await fetch('https://api.todo4you.com/api/v1/tickets/101/blockers/55/delete', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}` }, });

$ch = curl_init('https://api.todo4you.com/api/v1/tickets/101/blockers/55/delete'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests data = requests.post( 'https://api.todo4you.com/api/v1/tickets/101/blockers/55/delete', headers={'Authorization': f'Bearer {TOKEN}'}, ).json()

Bijlagen

Bestanden uploaden

POST /api/v1/tickets/{ticketId}/attachments

Uploadt een of meer bestanden naar een ticket. Verstuur als multipart/form-data met bestanden in het files[]-veld. Maximale bestandsgrootte is 10 MB per bestand. Geaccepteerde typen: afbeeldingen, PDF, Office-documenten, CSV, platte tekst en archieven. Vereist de rol editor of manager.

Padparameters

Parameter	Type	Beschrijving
ticketId	integer	Ticket ID

Request body (multipart/form-data)

Veld	Type		Beschrijving
files[]	file	verplicht	One or more files to upload

Antwoord

200 OK200

{ "ok": true, "attachments": [ { "id": 7, "ticket_id": 101, "original_name": "screenshot.png", "filesize": 48210, "mime_type": "image/png" } ] }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/tickets/101/attachments \ -H "Authorization: Bearer YOUR_TOKEN" \ -F "files[]=@screenshot.png" \ -F "files[]=@report.pdf"

$ch = curl_init('https://api.todo4you.com/api/v1/tickets/101/attachments'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => [ 'files[0]' => new \CURLFile('screenshot.png'), 'files[1]' => new \CURLFile('report.pdf'), ], CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests data = requests.post( 'https://api.todo4you.com/api/v1/tickets/101/attachments', headers={'Authorization': f'Bearer {TOKEN}'}, files=[ ('files[]', open('screenshot.png', 'rb')), ('files[]', open('report.pdf', 'rb')), ], ).json()

Bestand ophalen

GET /api/v1/attachments/{id}

Downloadt of toont een bijlage. Afbeeldingen en PDF's worden inline weergegeven; andere bestandstypen starten een download. De gebruiker moet minimaal viewer-toegang hebben tot het project.

Padparameters

Parameter	Type	Beschrijving
id	integer	Attachment ID

Antwoord

Geeft het binaire bestand terug met de juiste Content-Type- en Content-Disposition-headers.

Voorbeeld

curl https://api.todo4you.com/api/v1/attachments/7 \ -H "Authorization: Bearer YOUR_TOKEN" \ --output screenshot.png

const res = await fetch('https://api.todo4you.com/api/v1/attachments/7', { headers: { Authorization: `Bearer ${TOKEN}` }, }); const blob = await res.blob();

$ch = curl_init('https://api.todo4you.com/api/v1/attachments/7'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $fileData = curl_exec($ch); curl_close($ch); file_put_contents('screenshot.png', $fileData);

import requests resp = requests.get( 'https://api.todo4you.com/api/v1/attachments/7', headers={'Authorization': f'Bearer {TOKEN}'}, ) with open('screenshot.png', 'wb') as f: f.write(resp.content)

Bestand verwijderen

POST /api/v1/attachments/{id}/delete

Verwijdert een bijlage. Je kunt bestanden verwijderen die je hebt ge-upload, bestanden op tickets die je hebt aangemaakt, of elk bestand als je manager bent.

Padparameters

Parameter	Type	Beschrijving
id	integer	Attachment ID

Antwoord

200 OK200

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/attachments/7/delete \ -H "Authorization: Bearer YOUR_TOKEN"

await fetch('https://api.todo4you.com/api/v1/attachments/7/delete', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}` }, });

$ch = curl_init('https://api.todo4you.com/api/v1/attachments/7/delete'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests data = requests.post( 'https://api.todo4you.com/api/v1/attachments/7/delete', headers={'Authorization': f'Bearer {TOKEN}'}, ).json()

Opmerkingen

Opmerking bewerken

POST /api/v1/reactions/{id}/update

Werkt de tekst van een reactie bij. Je kunt alleen je eigen reacties bewerken.

Padparameters

Parameter	Type	Beschrijving
id	integer	Reaction (comment) ID

Request body (JSON)

Veld	Type		Beschrijving
message	string	verplicht	New comment text

Antwoord

200 OK200

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/reactions/15/update \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"message":"Updated comment text"}'

await fetch('https://api.todo4you.com/api/v1/reactions/15/update', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ message: 'Updated comment text' }), });

$payload = json_encode(['message' => 'Updated comment text']); $ch = curl_init('https://api.todo4you.com/api/v1/reactions/15/update'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests data = requests.post( 'https://api.todo4you.com/api/v1/reactions/15/update', headers={'Authorization': f'Bearer {TOKEN}'}, json={'message': 'Updated comment text'}, ).json()

Opmerking verwijderen

POST /api/v1/reactions/{id}/delete

Verwijdert een reactie met soft-delete. Je kunt je eigen reacties verwijderen; managers kunnen elke reactie verwijderen.

Padparameters

Parameter	Type	Beschrijving
id	integer	Reaction (comment) ID

Antwoord

200 OK200

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/reactions/15/delete \ -H "Authorization: Bearer YOUR_TOKEN"

await fetch('https://api.todo4you.com/api/v1/reactions/15/delete', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}` }, });

$ch = curl_init('https://api.todo4you.com/api/v1/reactions/15/delete'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests data = requests.post( 'https://api.todo4you.com/api/v1/reactions/15/delete', headers={'Authorization': f'Bearer {TOKEN}'}, ).json()

Reactiebestanden uploaden

POST /api/v1/reactions/{id}/attachments

Uploadt bestanden gekoppeld aan een specifieke reactie. Werkt hetzelfde als ticketbijlagen maar de bestanden zijn gekoppeld aan de reactie. Verstuur als multipart/form-data met files[].

Padparameters

Parameter	Type	Beschrijving
id	integer	Reaction (comment) ID

Request body (multipart/form-data)

Veld	Type		Beschrijving
files[]	file	verplicht	One or more files to upload

Antwoord

200 OK200

{ "ok": true, "attachments": [...] }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/reactions/15/attachments \ -H "Authorization: Bearer YOUR_TOKEN" \ -F "files[]=@image.png"

$ch = curl_init('https://api.todo4you.com/api/v1/reactions/15/attachments'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => [ 'files[0]' => new \CURLFile('image.png'), ], CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests data = requests.post( 'https://api.todo4you.com/api/v1/reactions/15/attachments', headers={'Authorization': f'Bearer {TOKEN}'}, files={'files[]': open('image.png', 'rb')}, ).json()

Tags weergeven

GET /api/v1/projects/{id}/tags

Geeft alle tags terug die in een project zijn gedefinieerd. Gebruik de id-waarden bij het aanmaken van tickets met het tags-veld.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID

Antwoord

200 OK200

{ "tags": [ { "id": 5, "name": "frontend", "color": "#e74c3c", "sort_order": 1 }, { "id": 12, "name": "backend", "color": "#3498db", "sort_order": 2 } ] }

Voorbeeld

curl https://api.todo4you.com/api/v1/projects/12/tags \ -H "Authorization: Bearer YOUR_TOKEN"

const { tags } = await (await fetch( 'https://api.todo4you.com/api/v1/projects/12/tags', { headers: { Authorization: `Bearer ${TOKEN}` } }, )).json();

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tags'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch); $tags = $data['tags'];

import requests data = requests.get( 'https://api.todo4you.com/api/v1/projects/12/tags', headers={'Authorization': f'Bearer {TOKEN}'}, ).json() tags = data['tags']

Tag aanmaken

POST /api/v1/projects/{id}/tags

Maakt een nieuwe tag aan in een project. Vereist de rol manager.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID

Request body (JSON)

Veld	Type		Beschrijving
name	string	verplicht	Tag name (max 100 characters)
color	string	optioneel	Hex color, e.g. `#e74c3c` Default: `#6c757d`

Antwoord

201 Created201

{ "tag": { "id": 18, "name": "frontend", "color": "#e74c3c", "sort_order": 3 } }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/tags \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"name":"frontend","color":"#e74c3c"}'

const { tag } = await (await fetch( 'https://api.todo4you.com/api/v1/projects/12/tags', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ name: 'frontend', color: '#e74c3c' }), }, )).json();

$payload = json_encode(['name' => 'frontend', 'color' => '#e74c3c']); $ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tags'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $payload, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer YOUR_TOKEN', 'Content-Type: application/json', ], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch); $tag = $data['tag'];

import requests resp = requests.post( 'https://api.todo4you.com/api/v1/projects/12/tags', headers={'Authorization': f'Bearer {TOKEN}'}, json={'name': 'frontend', 'color': '#e74c3c'}, ) tag = resp.json()['tag']

Tag verwijderen

POST /api/v1/projects/{id}/tags/{tagId}/delete

Verwijdert een tag uit een project. De tag wordt automatisch verwijderd van alle tickets die deze gebruiken. Vereist de rol manager.

Padparameters

Parameter	Type	Beschrijving
id	integer	Project ID
tagId	integer	Tag ID from List tags

Antwoord

200 OK200

{ "ok": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/tags/5/delete \ -H "Authorization: Bearer YOUR_TOKEN"

await fetch('https://api.todo4you.com/api/v1/projects/12/tags/5/delete', { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}` }, });

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/tags/5/delete'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests requests.post( 'https://api.todo4you.com/api/v1/projects/12/tags/5/delete', headers={'Authorization': f'Bearer {TOKEN}'}, )

Tijdregistratie

Tijdregistraties weergeven

GET /api/v1/tickets/{ticketId}/time-entries

Geeft alle tijdregistraties voor een ticket terug.

Padparameters

Parameter	Type	Beschrijving
ticketId	integer	The ticket ID

Antwoord

200 OK200

{ "success": true, "entries": [ { "id": 1, "ticket_id": 42, "user_id": 3, "project_id": 5, "minutes": 30, "is_running": 0, "started_at": "2025-01-15 09:00:00", "stopped_at": "2025-01-15 09:30:00", "user_name": "Alice", "user_avatar": "avatar.jpg" } ], "total_minutes": 45 }

Voorbeeld

curl https://api.todo4you.com/api/v1/tickets/42/time-entries \ -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch("https://api.todo4you.com/api/v1/tickets/42/time-entries", { headers: { "Authorization": "Bearer YOUR_TOKEN" } }); const data = await res.json();

$ch = curl_init("https://api.todo4you.com/api/v1/tickets/42/time-entries"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_TOKEN"]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $res = json_decode(curl_exec($ch), true);

import requests res = requests.get("https://api.todo4you.com/api/v1/tickets/42/time-entries", headers={"Authorization": "Bearer YOUR_TOKEN"}) data = res.json()

Handmatige registratie toevoegen

POST /api/v1/tickets/{ticketId}/time-entries

Voegt een handmatige tijdsregistratie toe (geen lopende timer).

Padparameters

Parameter	Type	Beschrijving
ticketId	integer	The ticket ID

Request body (JSON)

Veld	Type		Beschrijving
minutes	integer	verplicht	Duration in minutes (min 1)

Antwoord

200 OK200

{ "success": true, "entry": { "id": 2, "ticket_id": 42, "minutes": 30, "is_running": 0, "started_at": null, "stopped_at": null } }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/tickets/42/time-entries \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"minutes": 30}'

const res = await fetch("https://api.todo4you.com/api/v1/tickets/42/time-entries", { method: "POST", headers: { "Authorization": "Bearer YOUR_TOKEN", "Content-Type": "application/json" }, body: JSON.stringify({ minutes: 30 }) }); const data = await res.json();

$ch = curl_init("https://api.todo4you.com/api/v1/tickets/42/time-entries"); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Authorization: Bearer YOUR_TOKEN", "Content-Type: application/json" ]); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([ "minutes" => 30, ])); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $res = json_decode(curl_exec($ch), true);

import requests res = requests.post("https://api.todo4you.com/api/v1/tickets/42/time-entries", headers={"Authorization": "Bearer YOUR_TOKEN"}, json={"minutes": 30}) data = res.json()

Timer starten

POST /api/v1/tickets/{ticketId}/time-entries/start

Start een lopende timer op een ticket. Er kan maar een timer per gebruiker tegelijk lopen.

Padparameters

Parameter	Type	Beschrijving
ticketId	integer	The ticket ID

Antwoord

200 OK200

{ "success": true, "entry": { "id": 3, "ticket_id": 42, "minutes": 0, "is_running": 1, "started_at": "2025-01-15 09:00:00", "stopped_at": null, "ticket_title": "Fix login bug", "project_name": "My App", "ticket_ref": "APP-42" } }

422 Unprocessable Entity422

{ "error": "You already have a running timer.", "running_ticket_id": 55 }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/tickets/42/time-entries/start \ -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch("https://api.todo4you.com/api/v1/tickets/42/time-entries/start", { method: "POST", headers: { "Authorization": "Bearer YOUR_TOKEN" } }); const data = await res.json();

$ch = curl_init("https://api.todo4you.com/api/v1/tickets/42/time-entries/start"); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_TOKEN"]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $res = json_decode(curl_exec($ch), true);

import requests res = requests.post("https://api.todo4you.com/api/v1/tickets/42/time-entries/start", headers={"Authorization": "Bearer YOUR_TOKEN"}) data = res.json()

Timer stoppen

POST /api/v1/time-entries/{entryId}/stop

Stopt een lopende of gepauzeerde timer en berekent de uiteindelijke duur.

Padparameters

Parameter	Type	Beschrijving
entryId	integer	The time entry ID

Antwoord

200 OK200

{ "success": true, "entry": { "id": 3, "ticket_id": 42, "minutes": 45, "is_running": 0, "started_at": "2025-01-15 09:00:00", "stopped_at": "2025-01-15 09:45:00", "ticket_title": "Fix login bug", "project_name": "My App", "ticket_ref": "APP-42" } }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/time-entries/3/stop \ -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch("https://api.todo4you.com/api/v1/time-entries/3/stop", { method: "POST", headers: { "Authorization": "Bearer YOUR_TOKEN" } }); const data = await res.json();

$ch = curl_init("https://api.todo4you.com/api/v1/time-entries/3/stop"); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_TOKEN"]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $res = json_decode(curl_exec($ch), true);

import requests res = requests.post("https://api.todo4you.com/api/v1/time-entries/3/stop", headers={"Authorization": "Bearer YOUR_TOKEN"}) data = res.json()

Timer pauzeren

POST /api/v1/time-entries/{entryId}/pause

Pauzeert een lopende timer. Opgebouwde tijd wordt bewaard in het minutenveld.

Padparameters

Parameter	Type	Beschrijving
entryId	integer	The time entry ID

Antwoord

200 OK200

{ "success": true, "entry": { "id": 3, "ticket_id": 42, "minutes": 15, "is_running": 2, "started_at": "2025-01-15 09:00:00", "stopped_at": null, "ticket_title": "Fix login bug", "project_name": "My App", "ticket_ref": "APP-42" } }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/time-entries/3/pause \ -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch("https://api.todo4you.com/api/v1/time-entries/3/pause", { method: "POST", headers: { "Authorization": "Bearer YOUR_TOKEN" } }); const data = await res.json();

$ch = curl_init("https://api.todo4you.com/api/v1/time-entries/3/pause"); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_TOKEN"]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $res = json_decode(curl_exec($ch), true);

import requests res = requests.post("https://api.todo4you.com/api/v1/time-entries/3/pause", headers={"Authorization": "Bearer YOUR_TOKEN"}) data = res.json()

Timer hervatten

POST /api/v1/time-entries/{entryId}/resume

Hervat een gepauzeerde timer. Kan niet hervatten als er al een andere timer loopt.

Padparameters

Parameter	Type	Beschrijving
entryId	integer	The time entry ID

Antwoord

200 OK200

{ "success": true, "entry": { "id": 3, "ticket_id": 42, "minutes": 15, "is_running": 1, "started_at": "2025-01-15 10:00:00", "stopped_at": null, "ticket_title": "Fix login bug", "project_name": "My App", "ticket_ref": "APP-42" } }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/time-entries/3/resume \ -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch("https://api.todo4you.com/api/v1/time-entries/3/resume", { method: "POST", headers: { "Authorization": "Bearer YOUR_TOKEN" } }); const data = await res.json();

$ch = curl_init("https://api.todo4you.com/api/v1/time-entries/3/resume"); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_TOKEN"]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $res = json_decode(curl_exec($ch), true);

import requests res = requests.post("https://api.todo4you.com/api/v1/time-entries/3/resume", headers={"Authorization": "Bearer YOUR_TOKEN"}) data = res.json()

Invoer bijwerken

POST /api/v1/time-entries/{entryId}/update

Werkt de minuten van een gestopte tijdinvoer bij. Eigenaar of projectmanager kan bijwerken.

Padparameters

Parameter	Type	Beschrijving
entryId	integer	The time entry ID

Request body (JSON)

Veld	Type		Beschrijving
minutes	integer	verplicht	New duration in minutes (min 1)

Antwoord

200 OK200

{ "success": true, "entry": { "id": 3, "ticket_id": 42, "minutes": 60, "is_running": 0, "started_at": "2025-01-15 09:00:00", "stopped_at": "2025-01-15 09:45:00" } }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/time-entries/3/update \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"minutes": 60}'

const res = await fetch("https://api.todo4you.com/api/v1/time-entries/3/update", { method: "POST", headers: { "Authorization": "Bearer YOUR_TOKEN", "Content-Type": "application/json" }, body: JSON.stringify({ minutes: 60 }) }); const data = await res.json();

$ch = curl_init("https://api.todo4you.com/api/v1/time-entries/3/update"); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Authorization: Bearer YOUR_TOKEN", "Content-Type: application/json" ]); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["minutes" => 60])); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $res = json_decode(curl_exec($ch), true);

import requests res = requests.post("https://api.todo4you.com/api/v1/time-entries/3/update", headers={"Authorization": "Bearer YOUR_TOKEN"}, json={"minutes": 60}) data = res.json()

Item verwijderen

POST /api/v1/time-entries/{entryId}/delete

Verwijdert een tijdregistratie. De eigenaar of projectmanager kan verwijderen.

Padparameters

Parameter	Type	Beschrijving
entryId	integer	The time entry ID

Antwoord

200 OK200

{ "success": true }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/time-entries/3/delete \ -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch("https://api.todo4you.com/api/v1/time-entries/3/delete", { method: "POST", headers: { "Authorization": "Bearer YOUR_TOKEN" } }); const data = await res.json();

$ch = curl_init("https://api.todo4you.com/api/v1/time-entries/3/delete"); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_TOKEN"]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $res = json_decode(curl_exec($ch), true);

import requests res = requests.post("https://api.todo4you.com/api/v1/time-entries/3/delete", headers={"Authorization": "Bearer YOUR_TOKEN"}) data = res.json()

Lopende timer

GET /api/v1/time-entries/running

Geeft de momenteel lopende of gepauzeerde timer terug voor de geauthenticeerde gebruiker, met ticket- en projectdetails.

Antwoord

200 OK200

{ "success": true, "entry": { "id": 1, "ticket_id": 42, "minutes": 15, "is_running": 1, "started_at": "2025-01-15 09:00:00", "ticket_title": "Fix login bug", "project_name": "My App", "ticket_ref": "APP-5" } }

Wanneer er geen timer loopt, is entry null.

Voorbeeld

curl https://api.todo4you.com/api/v1/time-entries/running \ -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch("https://api.todo4you.com/api/v1/time-entries/running", { headers: { "Authorization": "Bearer YOUR_TOKEN" } }); const data = await res.json();

$ch = curl_init("https://api.todo4you.com/api/v1/time-entries/running"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_TOKEN"]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $res = json_decode(curl_exec($ch), true);

import requests res = requests.get("https://api.todo4you.com/api/v1/time-entries/running", headers={"Authorization": "Bearer YOUR_TOKEN"}) data = res.json()

Actieve timers

GET /api/v1/time-entries/active

Geeft alle lopende en gepauzeerde timers terug voor de geauthenticeerde gebruiker, met ticket- en projectdetails. Anders dan /time-entries/running dat slechts een item teruggeeft, geeft dit endpoint alle actieve timers terug.

Antwoord

200 OK200

{ "success": true, "entries": [ { "id": 1, "ticket_id": 42, "minutes": 15, "is_running": 1, "started_at": "2025-01-15 09:00:00", "ticket_title": "Fix login bug", "project_name": "My App", "ticket_ref": "APP-5" }, { "id": 2, "ticket_id": 18, "minutes": 45, "is_running": 2, "started_at": "2025-01-15 08:00:00", "ticket_title": "Update dashboard", "project_name": "My App", "ticket_ref": "APP-18" } ] }

Wanneer er geen timers actief zijn, is entries een lege array. is_running is 1 voor lopend en 2 voor gepauzeerd.

Voorbeeld

curl https://api.todo4you.com/api/v1/time-entries/active \ -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch("https://api.todo4you.com/api/v1/time-entries/active", { headers: { "Authorization": "Bearer YOUR_TOKEN" } }); const data = await res.json();

$ch = curl_init("https://api.todo4you.com/api/v1/time-entries/active"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_TOKEN"]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $res = json_decode(curl_exec($ch), true);

import requests res = requests.get("https://api.todo4you.com/api/v1/time-entries/active", headers={"Authorization": "Bearer YOUR_TOKEN"}) data = res.json()

Notificaties

Notificaties weergeven

GET /api/v1/notifications

Geeft de laatste 20 meldingen terug en markeert alles als gelezen.

Antwoord

200 OK200

{ "notifications": [ { "id": 1, "type": "reaction", "message": "commented on APP-5: Fix login bug", "ticket_id": 42, "project_id": 5, "read_at": null, "created_at": "2025-01-15 10:00:00" } ] }

Voorbeeld

curl https://api.todo4you.com/api/v1/notifications \ -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch("https://api.todo4you.com/api/v1/notifications", { headers: { "Authorization": "Bearer YOUR_TOKEN" } }); const data = await res.json();

$ch = curl_init("https://api.todo4you.com/api/v1/notifications"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_TOKEN"]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $res = json_decode(curl_exec($ch), true);

import requests res = requests.get("https://api.todo4you.com/api/v1/notifications", headers={"Authorization": "Bearer YOUR_TOKEN"}) data = res.json()

Aantal ongelezen

GET /api/v1/notifications/unread-count

Geeft het aantal ongelezen meldingen terug.

Antwoord

200 OK200

{ "count": 3 }

Voorbeeld

curl https://api.todo4you.com/api/v1/notifications/unread-count \ -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch("https://api.todo4you.com/api/v1/notifications/unread-count", { headers: { "Authorization": "Bearer YOUR_TOKEN" } }); const data = await res.json();

$ch = curl_init("https://api.todo4you.com/api/v1/notifications/unread-count"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer YOUR_TOKEN"]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $res = json_decode(curl_exec($ch), true);

import requests res = requests.get("https://api.todo4you.com/api/v1/notifications/unread-count", headers={"Authorization": "Bearer YOUR_TOKEN"}) data = res.json()

Als gelezen markeren voor ticket

POST /api/v1/notifications/mark-read-for-ticket

Markeert alle ongelezen notificaties voor een specifiek ticket als gelezen.

Request body (JSON)

Veld	Type		Beschrijving
ticket_id	integer	verplicht	The ticket ID to mark notifications as read for

Antwoord

200 OK200

{ "success": true, "unread_count": 3 }

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/notifications/mark-read-for-ticket \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"ticket_id": 42}'

const res = await fetch("https://api.todo4you.com/api/v1/notifications/mark-read-for-ticket", { method: "POST", headers: { "Authorization": "Bearer YOUR_TOKEN", "Content-Type": "application/json" }, body: JSON.stringify({ ticket_id: 42 }) }); const data = await res.json();

$ch = curl_init("https://api.todo4you.com/api/v1/notifications/mark-read-for-ticket"); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Authorization: Bearer YOUR_TOKEN", "Content-Type: application/json" ]); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["ticket_id" => 42])); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $res = json_decode(curl_exec($ch), true);

import requests res = requests.post("https://api.todo4you.com/api/v1/notifications/mark-read-for-ticket", headers={"Authorization": "Bearer YOUR_TOKEN"}, json={"ticket_id": 42}) data = res.json()

Documentatie

Documentatie-hoofdmap opvragen

GET /api/v1/projects/{id}/docs

Geeft mappen en artikelen in de hoofdmap van de documentatie van een project terug. Het antwoord bevat ook de role van de aanroepende gebruiker, zodat de client kan bepalen of schrijfacties zichtbaar zijn. Geeft 404 als documentatie niet aan staat voor het project (docs_enabled is false in de project-payload). Alle documentatie-endpoints gebruiken deze controle.

Antwoord

200 OK200

{ "success": true, "role": "manager", "current_folder": null, "breadcrumbs": [], "folders": [ { "id": 3, "project_id": 12, "parent_id": null, "title": "Onboarding", "slug": "onboarding", "sort_order": 0 } ], "articles": [ { "id": 7, "project_id": 12, "folder_id": null, "title": "Welcome", "slug": "welcome", "content": "# Welcome\n\nGetting started...", "sort_order": 0 } ] }

Voorbeeld

curl https://api.todo4you.com/api/v1/projects/12/docs \ -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch('https://api.todo4you.com/api/v1/projects/12/docs', { headers: { Authorization: `Bearer ${TOKEN}` }, }); const { folders, articles, role } = await res.json();

$ch = curl_init('https://api.todo4you.com/api/v1/projects/12/docs'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_TOKEN'], ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);

import requests data = requests.get( 'https://api.todo4you.com/api/v1/projects/12/docs', headers={'Authorization': f'Bearer {TOKEN}'}, ).json()

Inhoud van map opvragen

GET /api/v1/projects/{id}/docs/folders/{folder_id}

Zelfde structuur als de root-listing, maar beperkt tot de inhoud van één map. Het antwoord bevat een current_folder-object en de volledige breadcrumbs-keten van de root naar deze map.

Voorbeeld

curl https://api.todo4you.com/api/v1/projects/12/docs/folders/3 \ -H "Authorization: Bearer YOUR_TOKEN"

Map aanmaken

POST /api/v1/projects/{id}/docs/folders

Maakt een nieuwe map aan. Vereist contributor-rol of hoger.

Request body (JSON)

Veld	Type		Beschrijving
title	string	verplicht	Folder name
parent_id	integer	optioneel	Parent folder id, or null/omitted to create at the root

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/docs/folders \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"title":"Onboarding","parent_id":null}'

Map bijwerken

POST /api/v1/projects/{id}/docs/folders/{folder_id}

Hernoemt of verplaatst een map. Stuur alleen de velden die je wilt wijzigen. Vereist contributor-rol of hoger.

Request body (JSON)

Veld	Type		Beschrijving
title	string	optioneel	New title
parent_id	integer \| null	optioneel	Move to this parent. Pass `null` to move to the root. Omit to keep the parent unchanged. A folder cannot be its own parent.

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/docs/folders/3 \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"title":"Onboarding (renamed)"}'

Map verwijderen

POST /api/v1/projects/{id}/docs/folders/{folder_id}/delete

Verwijdert een map (soft delete). Onderliggende mappen en artikelen worden verplaatst naar de bovenliggende map in plaats van verwijderd, zodat niets verloren gaat. Vereist contributor-rol of hoger. Het antwoord bevat parent_id zodat de client die weergave kan vernieuwen.

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/docs/folders/3/delete \ -H "Authorization: Bearer YOUR_TOKEN"

Artikel opvragen

GET /api/v1/projects/{id}/docs/articles/{article_id}

Geeft de markdown-inhoud van het artikel terug, samen met bijlagen, reacties (met auteurinformatie), breadcrumbs, de role van de aanroepende gebruiker en current_user_id, zodat de client weet of "bewerken" / "verwijderen" zichtbaar moet zijn op individuele reacties.

Antwoord

200 OK200

{ "success": true, "role": "manager", "current_user_id": 42, "article": { "id": 7, "project_id": 12, "folder_id": null, "title": "Welcome", "slug": "welcome", "content": "# Welcome\n\nMarkdown body.", "created_by": 42, "updated_by": null }, "breadcrumbs": [], "attachments": [ { "id": 11, "original_name": "diagram.png", "filesize": 12345, "mime_type": "image/png" } ], "comments": [ { "id": 5, "user_id": 42, "user_name": "Jorden", "message": "Looks good" } ] }

Voorbeeld

curl https://api.todo4you.com/api/v1/projects/12/docs/articles/7 \ -H "Authorization: Bearer YOUR_TOKEN"

Artikel aanmaken

POST /api/v1/projects/{id}/docs/articles

Maakt een nieuw artikel aan. Markdown wordt ondersteund in content. Vereist contributor-rol of hoger.

Request body (JSON)

Veld	Type		Beschrijving
title	string	verplicht	Article title
content	string	optioneel	Markdown content. Defaults to empty string
folder_id	integer	optioneel	Folder to place the article in. Omit for root

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/docs/articles \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"title":"How we deploy","content":"## Steps\n1. Push to main","folder_id":3}'

Artikel bijwerken

POST /api/v1/projects/{id}/docs/articles/{article_id}

Bewerkt een artikel. Stuur alleen de velden die je wilt wijzigen. De server zet updated_by op de aanroepende gebruiker. Vereist contributor-rol of hoger.

Request body (JSON)

Veld	Type		Beschrijving
title	string	optioneel	New title
content	string	optioneel	New markdown content
folder_id	integer \| null	optioneel	Move to this folder. Pass `null` to move to root. Omit to leave unchanged.

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/docs/articles/7 \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"content":"Updated body."}'

Artikel verwijderen

POST /api/v1/projects/{id}/docs/articles/{article_id}/delete

Verwijdert een artikel (soft delete). Vereist contributor-rol of hoger.

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/docs/articles/7/delete \ -H "Authorization: Bearer YOUR_TOKEN"

Artikel kopiëren

POST /api/v1/projects/{id}/docs/articles/{article_id}/copy

Dupliceert een artikel in dezelfde map. Het nieuwe artikel krijgt het suffix (copy) in de titel en is eigendom van de aanroepende gebruiker. Vereist contributor-rol of hoger.

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/docs/articles/7/copy \ -H "Authorization: Bearer YOUR_TOKEN"

Reactie op artikel toevoegen

POST /api/v1/projects/{id}/docs/articles/{article_id}/comments

Plaatst een reactie op een artikel. Iedereen met view-toegang tot het project mag reageren.

Request body (JSON)

Veld	Type		Beschrijving
message	string	verplicht	Comment body

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/docs/articles/7/comments \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"message":"Looks good!"}'

Opmerking bewerken

POST /api/v1/projects/{id}/docs/comments/{comment_id}

Bewerkt een reactie. Alleen de auteur van de reactie mag zijn eigen reactie bewerken.

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/docs/comments/5 \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"message":"updated comment"}'

Opmerking verwijderen

POST /api/v1/projects/{id}/docs/comments/{comment_id}/delete

Verwijdert een reactie. De auteur van de reactie mag zijn eigen reactie verwijderen, een manager mag elke reactie verwijderen.

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/docs/comments/5/delete \ -H "Authorization: Bearer YOUR_TOKEN"

Bijlagen uploaden

POST /api/v1/projects/{id}/docs/articles/{article_id}/attachments

Uploadt één of meer bestanden naar een documentatie-artikel. Verstuur als multipart/form-data met bestanden in het files[]-veld. Maximaal 10 MB per bestand. Dezelfde toegestane types als ticket-bijlagen (afbeeldingen, PDF, Office-documenten, CSV, platte tekst, archieven). Vereist contributor-rol of hoger.

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/docs/articles/7/attachments \ -H "Authorization: Bearer YOUR_TOKEN" \ -F "files[]=@./diagram.png" \ -F "files[]=@./spec.pdf"

Get attachment

GET /api/v1/projects/{id}/docs/attachments/{attachment_id}

Stuurt het bestand terug. Afbeeldingen en PDF's worden inline weergegeven, andere types als download. Het endpoint stelt Content-Type, Content-Disposition en een private Cache-Control-header in.

Voorbeeld

curl -OJ https://api.todo4you.com/api/v1/projects/12/docs/attachments/11 \ -H "Authorization: Bearer YOUR_TOKEN"

Delete attachment

POST /api/v1/projects/{id}/docs/attachments/{attachment_id}/delete

Verwijdert een bijlage van schijf en uit de database. Vereist contributor-rol of hoger.

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/docs/attachments/11/delete \ -H "Authorization: Bearer YOUR_TOKEN"

Mappen en artikelen sorteren

POST /api/v1/projects/{id}/docs/sort

Stelt de sort_order in voor mappen en/of artikelen op basis van de volgorde in de request-arrays. De positie in elke array wordt de nieuwe sort_order. Vereist contributor-rol of hoger.

Request body (JSON)

Veld	Type		Beschrijving
folders	int[]	optioneel	Folder ids in the desired order
articles	int[]	optioneel	Article ids in the desired order

Voorbeeld

curl -X POST https://api.todo4you.com/api/v1/projects/12/docs/sort \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"folders":[3,1,2],"articles":[12,10,11]}'

Todo4you REST APIOntwikkelaarsreferentie

Authenticatie

Fouten

Projecten weergeven

Project aanmaken

Projectstatistieken

Projectstatussen

Leden weergeven

Tickets weergeven

Ticket ophalen

Tickets zoeken

Ticket aanmaken

Ticket bijwerken

Reactie toevoegen

Ticket verplaatsen

Ticket archiveren

Ticket uit archief halen

Gearchiveerde tickets opvragen

Ticket verwijderen

Lid toewijzen

Toewijzing lid opheffen

Boardgegevens

Tickets sorteren

Checklist-item toevoegen

Checklist-item aan/uit zetten

Checklist-item bijwerken

Checklist-item verwijderen

Checklist-items sorteren

Blokkade toevoegen

Blocker verwijderen

Bestanden uploaden

Bestand ophalen

Bestand verwijderen

Opmerking bewerken

Opmerking verwijderen

Reactiebestanden uploaden

Tags weergeven

Tag aanmaken

Tag verwijderen

Tijdregistraties weergeven

Handmatige registratie toevoegen

Timer starten

Timer stoppen

Timer pauzeren

Timer hervatten

Invoer bijwerken

Item verwijderen

Lopende timer

Actieve timers

Notificaties weergeven

Aantal ongelezen

Als gelezen markeren voor ticket

Documentatie-hoofdmap opvragen

Inhoud van map opvragen

Map aanmaken

Map bijwerken

Map verwijderen

Artikel opvragen

Artikel aanmaken

Artikel bijwerken

Artikel verwijderen

Artikel kopiëren

Reactie op artikel toevoegen

Opmerking bewerken

Opmerking verwijderen

Bijlagen uploaden

Get attachment

Delete attachment

Mappen en artikelen sorteren

Binnenkort beschikbaar

Todo4you REST API
Ontwikkelaarsreferentie