Créer une tâche

Ajoute une tâche à un projet — pour vous, ou à faire par le client dans son portail.

Crée une tâche dans un projet. audience: "client" en fait une tâche à réaliser par le client, visible dans son portail sous « Mes tâches » : c'est le levier pour lui demander une action — fournir un logo, valider une maquette.

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 à 300 caractères
`description`	string		20 000 caractères max ; accepte du HTML, rendu tel quel dans l'app
`status`	enum		`backlog`, `todo` (défaut), `doing`, `done`, `canceled`
`priority`	enum		`Urgent`, `Haute`, `Moyenne`, `Basse`
`due_date`	date		ISO 8601 ou `YYYY-MM-DD`
`labels`	string[]		20 maximum, 60 caractères chacun
`audience`	enum		`freelance` (défaut) ou `client`
`client_can_validate`	boolean		Le client peut marquer la tâche comme validée
`milestone_id`	string		Étape du projet à laquelle rattacher la tâche
`assignee_ids`	string[]		Membres à qui confier la tâche — ids utilisateur ou e-mails, 20 max ; voir Lister les membres

Les tâches en backlog ne sont pas visibles côté client : elles restent internes tant qu'elles ne passent pas en todo.

Cette route accepte un en-tête Idempotency-Key.

Exemple

curl -X POST "https://www.tetikasa.app/api/v1/projects/refonte-du-site-vitrine/tasks" \
  -H "Authorization: Bearer $TETIKASA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Valider la maquette","audience":"client","client_can_validate":true,"due_date":"2026-10-01"}'

Réponse

Statut 201. Le slug est unique dans le projet et sert d'URL lisible : la tâche est directement atteignable à /orgs/{orgSlug}/projects/{projectSlug}/taches?task={slug}. Il ne change pas si la tâche est renommée.

Erreurs

`code`	Statut	Quand
`invalid_request`	422	Corps invalide, ou un `assignee_ids` qui n'est pas membre de l'organisation — `details` liste les champs fautifs
`not_found`	404	Projet inexistant ou d'une autre organisation ; `milestone_id` inconnu dans ce projet
`unauthorized`	401	Clé absente, invalide, révoquée ou expirée

Rechercher dans la documentation