Aufgabe erstellen

Erstellt eine neue Aufgabe.

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

Request

POST /api/oauth/v2/resource/todos

Header

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

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
statusUuid	string	Nein	UUID des Status. Verfügbare Status siehe Status abrufen. Ohne Angabe bekommt die Aufgabe automatisch den Status vom Typ open des Unternehmens (oder den ersten konfigurierten Status, falls keiner vom Typ open existiert)
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.

Response

Erfolg (201 Created)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "number": "A-0001",
    "name": "Rückruf Patientin",
    "description": "Rückruf wegen Terminverschiebung",
    "priority": "normal",
    "dueDate": "2026-06-10T00: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-01T08:15: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.

Beispiele

bash

curl -X POST "https://my.offisy.at/api/oauth/v2/resource/todos" \
  -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",
    "statusUuid": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
    "tagUuids": "b2c3d4e5-f6a7-8901-bcde-f01234567890"
  }'

Server

Client-ID

Client-Secret

Parameter

name *string

description string

priority string

dueDate string

customerUuid string

assignedToUuid string

statusUuid string

tagUuids string

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
400	validation_error	Ungültige Request-Daten (z.B. name fehlt)
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	validation_error	statusUuid must belong to the same company as the todo.
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 verwendet ohne den zusätzlich erforderlichen Scope customers/users
403	access_denied	Der Besitzer-Benutzer deines API-Zugangs hat keine Berechtigung zum Erstellen von Aufgaben in der Firma des OAuth-Clients (error_description: Insufficient permission for this resource.)
404	not_found	statusUuid hat kein gültiges UUID-Format, oder eine UUID in tagUuids hat kein gültiges UUID-Format