POST
/api/v1/projects/{ref}/milestonesCréer une étape
Ajoute une étape à la suite des existantes. Une étape regroupe des tâches et peut être validée par le client.
Crée une étape de projet. Elle est ajoutée à la suite des étapes
existantes ; son order est calculé automatiquement. Pour y rattacher une
tâche, passez son id dans milestone_id à la création de la
tâche.
Paramètres de chemin
| Paramètre | Description |
|---|---|
ref | L'id ou le slug du projet |
Corps de la requête
| Champ | Type | Requis | Contraintes |
|---|---|---|---|
title | string | oui | 1 à 200 caractères |
description | string | 5 000 caractères max | |
status | enum | pending (défaut), in_progress, done | |
due_date | date | ISO 8601 ou YYYY-MM-DD | |
client_can_validate | boolean | Le client peut valider l'étape depuis son portail |
Cette route accepte un en-tête Idempotency-Key.
Exemple
curl -X POST "https://www.tetikasa.app/api/v1/projects/refonte-du-site-vitrine/milestones" \
-H "Authorization: Bearer $TETIKASA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Maquettes","client_can_validate":true,"due_date":"2026-10-15"}'Erreurs
code | Statut | Quand |
|---|---|---|
invalid_request | 422 | Corps invalide — details liste les champs fautifs |
not_found | 404 | Projet inexistant ou d'une autre organisation |
unauthorized | 401 | Clé absente, invalide, révoquée ou expirée |
