Aufgaben

Aufgabe ändern

patchhttps://open-api.mynextdays.com/v1/tasks/{task_id}

Status, Zuständige, Fälligkeit oder Beschreibung ändern.

status: "done" setzt zusätzlich den Abschlusszeitpunkt. Der Gegenzustand gehört dazu: ein Statuswechsel ohne completed_at ergäbe eine erledigte Aufgabe, die in jeder Auswertung nach Abschlusszeitpunkt fehlt (Wurzel 1). Wird sie wieder geöffnet, wird der Zeitpunkt entfernt.

Pfad-Parameter

task_idstringpflicht

Anfrage-Körperpflicht

assignee_idstring

descriptionstring

due_atdate-time

priorityinteger

statusstring

Erlaubt:openacceptedin_progressdonecancelled

Antworten

200Successful Response

assignee_idstring

completed_atdate-time

created_atdate-timepflicht

descriptionstring

due_atdate-time

end_atdate-time

idstringpflicht

priorityinteger

property_idstring

reservation_idstring

start_atdate-time

statusstringpflicht

Erlaubt:openacceptedin_progressdonecancelled

titlestringpflicht

422Validation Error

detailarray of ValidationError

ctxContext

inputInput

locarray of string | integerpflicht

msgstringpflicht

typestringpflicht

Sprache

Zugang

Nur in diesem Browser, nur für „Ausprobieren“ — der Wert wird nicht gespeichert und nicht an uns geschickt.

Anfrage

curl -X PATCH 'https://open-api.mynextdays.com/v1/tasks/%3Ctask_id%3E' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "assignee_id": "…",
  "description": "…",
  "due_at": "2026-09-10T14:00:00Z",
  "priority": 0
}'

Ohne Token antwortet der Aufruf mit 401 — das ist der erwartete Weg.

Beispiel

{
  "id": "…",
  "title": "…",
  "status": "open",
  "created_at": "2026-09-10T14:00:00Z"
}