PATCH
/api/v1/projects/{ref}/tasks/{task}Modifier une tâche
Met à jour une tâche : seuls les champs fournis changent.
Modifie une tâche. Seuls les champs présents dans le corps sont modifiés ; les autres restent tels quels. Un corps vide est refusé.
Paramètres de chemin
| Paramètre | Description |
|---|---|
ref | L'id ou le slug du projet |
task | L'id ou le slug de la tâche, dans ce projet |
Corps de la requête
Les mêmes champs qu'à la création, tous optionnels.
Quatre d'entre eux acceptent null pour effacer la valeur :
| Champ | Type | Peut valoir null |
|---|---|---|
title | string | |
description | string | oui |
status | enum | |
priority | enum | oui |
due_date | date | oui |
labels | string[] | |
audience | enum | |
client_can_validate | boolean | |
milestone_id | string | oui — détache la tâche de son étape |
assignee_ids | string[] | — la liste remplace les assignés ; [] retire tout le monde |
Exemple
curl -X PATCH "https://www.tetikasa.app/api/v1/projects/refonte-du-site-vitrine/tasks/valider-la-maquette" \
-H "Authorization: Bearer $TETIKASA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"status":"done","priority":"Urgent"}'Comportements à connaître
- Le
slugne change pas quand le titre change. Les liens déjà partagés restent valides — c'est la même règle qu'à la création. completed_atsuit le statut : renseigné au passage endone, effacé sinon. Vous n'avez pas à le gérer.
Erreurs
code | Statut | Quand |
|---|---|---|
invalid_request | 422 | Corps vide ou invalide, ou un assignee_ids qui n'est pas membre — details liste les champs fautifs |
not_found | 404 | Projet ou tâche introuvable ; milestone_id inconnu dans ce projet |
unauthorized | 401 | Clé absente, invalide, révoquée ou expirée |