Rechercher dans la documentation

Tapez pour filtrer les pages, les guides et les endpoints.

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ètreDescription
refL'id ou le slug du projet
taskL'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 :

ChampTypePeut valoir null
titlestring
descriptionstringoui
statusenum
priorityenumoui
due_datedateoui
labelsstring[]
audienceenum
client_can_validateboolean
milestone_idstringoui — détache la tâche de son étape
assignee_idsstring[]— 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 slug ne 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_at suit le statut : renseigné au passage en done, effacé sinon. Vous n'avez pas à le gérer.

Erreurs

codeStatutQuand
invalid_request422Corps vide ou invalide, ou un assignee_ids qui n'est pas membre — details liste les champs fautifs
not_found404Projet ou tâche introuvable ; milestone_id inconnu dans ce projet
unauthorized401Clé absente, invalide, révoquée ou expirée
PrivacyTermsapp icon