Aufgaben

Offene Punkte zur Nachverfolgung für das Team, optional mit einem Angebot verknüpft.

Was die API bietet

Die Aufgaben-API hat eine einzige Methode: POST /api/v1/tareas, um eine Aufgabe zu erstellen. Es gibt keine Endpoints, um Aufgaben über die API aufzulisten, zu bearbeiten, abzuschließen oder zu löschen; das erledigen Sie in der App. Um von Änderungen zu erfahren, empfangen Sie die Ereignisse task.created und task.completed per Webhooks oder fragen Sie sie im Ereignisverlauf ab.

Eine Aufgabe erstellen

POST /api/v1/tareas erstellt eine Aufgabe im Eingang des Teams. Erfordert einen Schlüssel mit Schreibberechtigung (bei einem eingeschränkten Schlüssel write auf die Ressource tareas) und akzeptiert Idempotency-Key.

Feld	Pflicht	Details
`titulo`	Ja	Text der Aufgabe. Gespeichert werden die ersten 200 Zeichen; der Rest wird ohne Fehler verworfen.
`due_date`	Nein	Fälligkeitsdatum im Format `YYYY-MM-DD`.
`cotizacion_id`	Nein	UUID eines Angebots Ihrer Organisation, mit dem die Aufgabe verknüpft wird.
`factura_id`	Nein	UUID einer Rechnung Ihrer Organisation (die `id` aus `/api/v1/facturas`), mit der die Aufgabe verknüpft wird. Kann zusammen mit `cotizacion_id` angegeben werden.

Jedes andere Feld im Body (zum Beispiel asignado_a, prioridad oder notas) wird ohne Fehler ignoriert: Über die API lassen sich weder zuständige Person noch Priorität oder Notizen festlegen.

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" } }

Die Aufgabe entsteht ohne zuständige Person und mit normaler Priorität. In der App legen Sie zuständige Person, Priorität und Notizen unter Aufgaben fest; solange niemand zuständig ist, geht die morgendliche Erinnerung per E-Mail an den Inhaber des Kontos.

Mit einem Testschlüssel (sk_test_) wird die Aufgabe in der Testumgebung erstellt, die keine Erinnerungen versendet.

Jede neue Aufgabe löst das Ereignis task.created aus, mit cotizacion_id und factura_id (oder null). Auch die Aufgaben, die Cord selbst anlegt (Rückbuchung und SPEI-Rückerstattung), lösen es aus. Wenn jemand die Aufgabe in der App als erledigt markiert, wird task.completed ausgelöst.

Mögliche Fehler

Code	Wann
`invalid_request` (400)	`titulo` fehlt (oder ist leer), oder `due_date` ist kein echtes Datum im Format `YYYY-MM-DD` (zum Beispiel wird `2026-02-30` abgelehnt).
`not_found` (404)	`cotizacion_id` oder `factura_id` ist keine UUID oder kein Angebot bzw. keine Rechnung Ihrer Organisation. Die Meldung erscheint in der Sprache Ihres Kontos.
`invalid_json` (400)	Der Body ist kein gültiges JSON.
`insufficient_scope` / `insufficient_permissions` (403)	Der Schlüssel ist nur lesend, oder es ist ein eingeschränkter Schlüssel ohne `write` auf `tareas`.

Die übrigen allgemeinen Codes finden Sie unter Fehlerbehandlung.