API: Marker en opgave som færdig

Opgavelistens Status og fluebenet følger stadiet, ikke kun feltet status. Derfor skal integrationen kende det stadie, der betyder færdig.

Forudsætninger

• API-nøgle med adgang til projekter
• Opgavens id

Sådan gør du

1. Kald GET /api/v1/task-flow
2. Find completedStageId i svaret. Det er det færdige stadie. Standard er 4 (Færdig). Har I egne statusser under Opgavestatusser, kan id'et være et andet
3. Kald PUT /api/v1/projects/tasks/:taskId med stage sat til det id

Du kan også sende status som done. Så sættes stadiet automatisk til det færdige stadie. Sender du begge, bruges stage.

Gyldige statusværdier er to_do, in_progress, blocked og done.

Resultat

Opgaven står som færdig i listen, og fluebenet er sat. POST /api/v1/projects/tasks/:taskId/move kan det samme med enten stage eller status.

Fejlsøgning

Symptom	Løsning
Statuskolonnen bliver på At gøre	I har sendt en status, som ikke findes. Brug done eller stage fra task-flow
HTTP 400 på stage	Id'et findes ikke i flowet. Hent GET /api/v1/task-flow igen
Forkert færdig-stadie	I har ændret Opgavestatusser. Brug det nye completedStageId

Relateret

• API og webhooks
• Projekter