Tâches

Des actions de suivi pour l’équipe, éventuellement liées à un devis.

Ce que propose l’API

L’API des tâches ne comporte qu’une seule méthode : POST /api/v1/tareas, pour créer une tâche. Il n’existe pas d’endpoint pour lister, modifier, terminer ou supprimer des tâches par l’API ; cela se fait depuis l’application. Pour être informé des changements, écoutez les événements task.created et task.completed avec des webhooks ou consultez-les dans l’historique des événements.

Créer une tâche

POST /api/v1/tareas crée une tâche dans la boîte de réception de l’équipe. Nécessite une clé avec le droit d’écriture (pour une clé restreinte, write sur la ressource tareas) et accepte Idempotency-Key.

Champ	Obligatoire	Détail
`titulo`	Oui	Texte de la tâche. Les 200 premiers caractères sont conservés ; le reste est écarté sans erreur.
`due_date`	Non	Date limite au format `YYYY-MM-DD`.
`cotizacion_id`	Non	UUID d’un devis de votre organisation auquel lier la tâche.
`factura_id`	Non	UUID d’une facture de votre organisation (l’`id` de `/api/v1/facturas`) à laquelle lier la tâche. Peut être envoyé avec `cotizacion_id`.

Tout autre champ du corps (par exemple asignado_a, prioridad ou notas) est ignoré sans erreur : le responsable, la priorité et les notes ne peuvent pas être définis par l’API.

curl -X POST "https://cordhq.app/api/v1/tareas" \
     -H "Authorization: Bearer sk_live_tU..." \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: follow-up-cot-00104" \
     -d '{
       "titulo": "Call Stark Industries about COT-00104",
       "due_date": "2026-09-20",
       "cotizacion_id": "2a9d8e4f-6b1c-4d7a-9e3f-5c8b1a2d4e6f"
     }'

{ "data": { "id": "7c1e0b4a-3f2d-4e8c-9a6b-5d1f0e2c3b4a" } }

La tâche est créée sans responsable et avec une priorité normale. Dans l’application, le responsable, la priorité et les notes se définissent depuis Tâches ; tant qu’elle n’a pas de responsable, le rappel par e-mail du matin est adressé au propriétaire du compte.

Avec une clé de test (sk_test_), la tâche est créée dans l’environnement de test, qui n’envoie pas de rappels.

Chaque nouvelle tâche émet l’événement task.created, avec cotizacion_id et factura_id (ou null). Les tâches que Cord crée de lui-même (rétrofacturation et remboursement SPEI) l’émettent aussi. Lorsque quelqu’un la marque comme terminée dans l’application, task.completed est émis.

Erreurs possibles

Code	Quand
`invalid_request` (400)	`titulo` est manquant (ou vide), ou `due_date` n’est pas une date réelle au format `YYYY-MM-DD` (par exemple, `2026-02-30` est rejetée).
`not_found` (404)	`cotizacion_id` ou `factura_id` n’est pas un UUID, ou ne correspond pas à un devis ou à une facture de votre organisation. Le message est rédigé dans la langue de votre compte.
`invalid_json` (400)	Le corps n’est pas un JSON valide.
`insufficient_scope` / `insufficient_permissions` (403)	La clé est en lecture seule, ou c’est une clé restreinte sans `write` sur `tareas`.

Les autres codes courants figurent dans Gestion des erreurs.