v1Ressourcen/Approvals/postAufgabe erstellen
Aufgabe erstellen
Erstellt eine Aufgabe in Aufgaben & Freigaben. Eine Aufgabe ist eine Arbeit, die Ihr Team für einen Kunden verfolgt, oder für die Agentur selbst, wenn Sie clientId weglassen. Im selben Aufruf können Sie eine verantwortliche Person, einen Freigebenden und bis zu 25 Unteraufgaben festlegen. Hier angelegte Unteraufgaben übernehmen verantwortliche Person, Freigebenden, Priorität und Termine der Aufgabe, sofern Sie keine eigenen Werte angeben. Um eine Unteraufgabe zu einer bestehenden offenen Aufgabe anzulegen, übergeben Sie stattdessen parentTaskId. Ist die verantwortliche Person ein Kundenbenutzer und lassen Sie clientId weg, wird die Aufgabe für den Kunden dieses Kundenbenutzers erstellt. Wiederholungen sind sicher: Derselbe idempotencyKey mit demselben Body liefert das erste Ergebnis mit replayed auf true. Wird ein Schlüssel mit einem anderen Body erneut verwendet, wird 409 zurückgegeben. Ist Aufgaben & Freigaben für Ihren Workspace nicht aktiviert, wird 404 zurückgegeben.
post
approvals:write/api/v1/work-management/tasksAnfragetext
idempotencyKeystringerforderlich
Eine eindeutige Zeichenfolge Ihrer Wahl mit 8 bis 200 Zeichen. Verwenden Sie sie nur erneut, um dieselbe Anfrage zu wiederholen.
clientIdstringoptional
Der Kunde, für den die Aufgabe ist. Lassen Sie den Wert weg oder senden Sie null für Agenturarbeit. Mit einem Schlüssel für alle Kunden wird die ID, die öffentliche ID oder der Slug des Kunden akzeptiert. Mit einem auf bestimmte Kunden beschränkten Schlüssel übergeben Sie die ID des Kunden; jeder andere Wert oder ein Kunde außerhalb des Zugriffs des Schlüssels liefert 403. Eine Unteraufgabe hat immer den Kunden ihrer übergeordneten Aufgabe. Ein anderer Kunde liefert 400.
titlestringerforderlich
Der Titel der Aufgabe, bis zu 500 Zeichen.
descriptionstringoptional
Was zu tun ist, bis zu 20.000 Zeichen.
locationIdstringoptional
Ein Standort des Kunden der Aufgabe, auf den sich die Aufgabe bezieht. Ein Standort eines anderen Kunden liefert 400.
projectIdstringoptional
Ein Projekt desselben Kunden, unter dem die Aufgabe gruppiert wird.
parentTaskIdstringoptional
Legt die Aufgabe als Unteraufgabe einer bestehenden Aufgabe an. Die übergeordnete Aufgabe muss offen sein und darf selbst keine Unteraufgabe sein. Die neue Unteraufgabe übernimmt verantwortliche Person, Freigebenden, Projekt, Standort, Priorität, Fälligkeits- und Startdatum der übergeordneten Aufgabe, sofern Sie keine eigenen Werte senden. Nicht mit subtasks kombinierbar.
metaobjectoptional
Priorität und Fälligkeitsdatum. Senden Sie beide Felder zusammen. Standard ist Priorität medium ohne Fälligkeitsdatum.
prioritystring (urgent | high | medium | low)erforderlich
Wie dringend die Aufgabe ist.
dueDatestringerforderlich
Fälligkeitsdatum im Format YYYY-MM-DD in der Zeitzone Ihres Workspace oder null.
detailsobjectoptional
Labels, Startdatum und Zeitschätzung.
labelsarray of stringoptional
Bis zu 10 Labels mit je 40 Zeichen. Duplikate, die sich nur in der Groß- und Kleinschreibung unterscheiden, werden zusammengeführt.
startDatestringoptional
Startdatum im Format YYYY-MM-DD oder null. Es darf nicht nach dem Fälligkeitsdatum liegen.
estimatedMinutesintegeroptional
Geschätzter Aufwand in Minuten oder null.
subtasksarray of objectoptional
Bis zu 25 Unteraufgaben, die mit der Aufgabe erstellt werden. Jede übernimmt verantwortliche Person, Freigebenden, Priorität, Fälligkeits- und Startdatum der Aufgabe, sofern Sie keine eigenen Werte angeben.
titlestringerforderlich
Der Titel der Unteraufgabe, bis zu 200 Zeichen.
descriptionstringoptional
Worum es in der Unteraufgabe geht, bis zu 20.000 Zeichen.
ownerIdstringoptional
Die verantwortliche Person der Unteraufgabe. Weglassen, um die der Aufgabe zu übernehmen, oder null für keine verantwortliche Person.
ownerTypestring (user | client_user)optional
Ob die verantwortliche Person ein Teammitglied der Agentur (user) oder ein Kundenbenutzer (client_user) ist. Standard ist user.
approverIdstringoptional
Der Freigebende der Unteraufgabe. Weglassen, um den der Aufgabe zu übernehmen, oder null für keinen.
dueDatestringoptional
Fälligkeitsdatum der Unteraufgabe im Format YYYY-MM-DD oder null.
startDatestringoptional
Startdatum der Unteraufgabe im Format YYYY-MM-DD oder null.
prioritystring (urgent | high | medium | low)optional
Die Priorität der Unteraufgabe.
ownerIdstringoptional
Die ID der verantwortlichen Person aus GET /api/v1/work-management/owners. Senden Sie null für keine verantwortliche Person. Bei einer Unteraufgabe wird ohne diesen Wert die verantwortliche Person der übergeordneten Aufgabe übernommen.
ownerTypestring (user | client_user)optional
Ob die verantwortliche Person ein Teammitglied der Agentur (user) oder ein Kundenbenutzer (client_user) ist. Standard ist user.
approverIdstringoptional
Die ID eines Teammitglieds der Agentur, das die Arbeit an der Aufgabe freigibt, wenn eine Freigabe angefordert wird. Senden Sie null für keinen.
Antwort
okbooleanoptional
Bei einer erfolgreichen Antwort immer true.
dataobjectoptional
keystringoptional
Der Schlüssel der Aufgabe im Format task:<id>.
rowVersionintegeroptional
Die Versionsnummer der Aufgabe. Sie steigt bei jeder Bearbeitung der Aufgabe.
replayedbooleanoptional
true, wenn diese Antwort eine frühere Anfrage mit demselben idempotencyKey wiederholt. Es wurde nichts Neues gespeichert.
Fehler
400Fehler aus Aufgaben & Freigaben kommen als ok: false mit einem error-Objekt aus code, message, retryable und details zurück. Fehler der API-Schlüsselprüfung selbst (fehlender oder ungültiger Schlüssel, fehlender Scope, Rate-Limit) verwenden das Standardformat, in dem error ein String ist.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Fehler aus Aufgaben & Freigaben kommen als ok: false mit einem error-Objekt aus code, message, retryable und details zurück. Fehler der API-Schlüsselprüfung selbst (fehlender oder ungültiger Schlüssel, fehlender Scope, Rate-Limit) verwenden das Standardformat, in dem error ein String ist.
404Fehler aus Aufgaben & Freigaben kommen als ok: false mit einem error-Objekt aus code, message, retryable und details zurück. Fehler der API-Schlüsselprüfung selbst (fehlender oder ungültiger Schlüssel, fehlender Scope, Rate-Limit) verwenden das Standardformat, in dem error ein String ist.
409Fehler aus Aufgaben & Freigaben kommen als ok: false mit einem error-Objekt aus code, message, retryable und details zurück. Fehler der API-Schlüsselprüfung selbst (fehlender oder ungültiger Schlüssel, fehlender Scope, Rate-Limit) verwenden das Standardformat, in dem error ein String ist.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
500Die Anfrage konnte wegen eines Problems auf unserer Seite nicht abgeschlossen werden.
post/api/v1/work-management/tasks
Ihr API-Schlüssel
Anfragetext*
{}