Aufgabe bearbeiten

Ändert die Daten einer bestehenden Aufgabe.

Hinweis: Dieser Endpoint erfordert einen benutzerbezogenen OAuth-Token. Ein reiner client_credentials-Token ohne Benutzerkontext wird mit 400 invalid_request abgelehnt.

Hinweis: Dies ist ein Teil-Update. Nur mitgeschickte Felder werden geändert, nicht übermittelte optionale Felder bleiben unverändert. Nur name ist Pflicht. Zum Leeren eines Felds einen expliziten Leerwert senden: "" bei Textfeldern, [] bei tagUuids, null bei customerUuid und assignedToUuid.

Request

PUT /api/oauth/v2/resource/todos/{uuid}

Header

Header	Wert
Authorization	Bearer {access_token}
Content-Type	application/json

URL-Parameter

Parameter	Typ	Pflicht	Beschreibung
uuid	string	Ja	Eindeutige Aufgaben-ID

Body-Parameter

Feld	Typ	Pflicht	Beschreibung
name	string	Ja	Titel der Aufgabe
description	string	Nein	Beschreibung
priority	string	Nein	Priorität (low, medium, normal, high, critical; Standard: normal)
dueDate	string	Nein	Fälligkeitsdatum (YYYY-MM-DD oder ISO-8601-Zeitstempel, Offset optional, siehe Hinweis)
customerUuid	string	Nein	UUID des zugeordneten Kunden. Erfordert zusätzlich den Scope customers
assignedToUuid	string	Nein	UUID des zugewiesenen Mitarbeiters. Erfordert zusätzlich den Scope users
tagUuids	array (string)	Nein	UUIDs der zugeordneten Tags

Hinweis: dueDate ist ein Tag. Du sendest YYYY-MM-DD oder einen ISO-8601-Zeitstempel. Der Offset ist optional, ohne Offset gilt die Server-Zeitzone. Ein Zeitstempel zählt für den Tag, auf den er in der Server-Zeitzone fällt, nicht in der Zeitzone des Clients: Bei Sommerzeit (+02:00) wird 2026-06-10T23:30:00Z zum 11.06. Die Uhrzeit wird verworfen. Der zurückgegebene Wert enthält immer den Tagesbeginn (00:00:00). Ein unmögliches Datum wie 2026-02-31 ergibt 400 validation_error.

Hinweis: statusUuid ist hier kein gültiges Feld. Der Status wird ausschließlich über Status setzen geändert – wird statusUuid trotzdem mitgeschickt, antwortet der Endpoint mit 400 validation_error und verweist auf den Status-Endpoint.

Response

Erfolg (200 OK)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "number": "A-0001",
    "name": "Rückruf Patientin (erledigt)",
    "description": "Rückruf wegen Terminverschiebung",
    "priority": "high",
    "dueDate": "2026-06-12T00:00:00+02:00",
    "status": "c3d4e5f6-a7b8-9012-cdef-345678901234",
    "tags": ["e5f6a7b8-9012-3456-ef01-567890123456"],
    "assignedTo": "d4c5b6a7-8901-2345-6789-0abcdef12345",
    "customer": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
    "createdAt": "2026-06-01T08:15:00+02:00",
    "updatedAt": "2026-06-08T11:42:00+02:00",
    "createdBy": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
    "updatedBy": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
    "deleted": false,
    "deletedAt": null
  }
}

Response-Felder

Siehe Aufgabe anzeigen für die vollständige Feldbeschreibung. Das Feld status bleibt bei einer Bearbeitung unverändert.

Beispiele

bash

curl -X PUT "https://my.offisy.at/api/oauth/v2/resource/todos/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Muster GmbH",
    "description": "beispiel",
    "priority": "normal",
    "dueDate": "2026-04-15T10:00:00",
    "customerUuid": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
    "assignedToUuid": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
    "tagUuids": "b2c3d4e5-f6a7-8901-bcde-f01234567890"
  }'

Server

Client-ID

Client-Secret

Parameter

uuid *string

name *string

description string

priority string

dueDate string

customerUuid string

assignedToUuid string

tagUuids string

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
400	validation_error	Ungültige Request-Daten (z.B. name fehlt, statusUuid mitgeschickt, oder Aufgabe bereits gelöscht)
400	validation_error	priority enthält einen ungültigen Wert (auch true oder 1 sind ungültig)
400	validation_error	dueDate ist kein gültiges Datum und kein gültiger ISO-8601-Zeitstempel (Invalid dueDate. Expected a date (YYYY-MM-DD) or an ISO 8601 timestamp.)
400	validation_error	assignedToUuid must belong to the same company as the todo.
400	validation_error	tagUuids must belong to the same company as the todo: <uuid>
400	invalid_request	Access Token ohne Benutzerkontext
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope todos nicht vorhanden, oder customerUuid/assignedToUuid gesetzt oder entfernt ohne den zusätzlich erforderlichen Scope customers/users
404	not_found	Aufgabe nicht gefunden, oder eine UUID in tagUuids hat kein gültiges UUID-Format