v1Ressourcen/Approvals/putVerantwortliche Person einer Aufgabe festlegen
Verantwortliche Person einer Aufgabe festlegen
Ersetzt den Aufgabenverantwortlichen durch ein berechtigtes Agenturmitglied oder einen Kundenbenutzer. Aufrufende Person und neue verantwortliche Person müssen bereits Zugriff gemäß den aktuellen Kunden- und Privatprojektbeschränkungen haben. Eine Zuweisung erteilt keine Freigabe. Kundenbenutzer müssen zum Kunden der Aufgabe gehören; Aufgaben ohne Kunden können ihnen nicht zugewiesen werden. Während einer ausstehenden Prüfung sind Änderungen gesperrt.
put
approvals:write/api/v1/work-management/tasks/{id}/ownerQuery-Parameter
idstringerforderlich
Die ID der Aufgabe, eine UUID. Jeder andere Wert liefert 404.
Anfragetext
idempotencyKeystringerforderlich
Eine eindeutige Zeichenfolge Ihrer Wahl mit 8 bis 200 Zeichen. Verwenden Sie sie nur erneut, um dieselbe Anfrage zu wiederholen.
userIdstringerforderlich
Die ID der neuen verantwortlichen Person aus GET /api/v1/work-management/owners.
ownerTypestring (user | client_user)optional
Ob die verantwortliche Person ein Teammitglied der Agentur (user) oder ein Kundenbenutzer (client_user) ist. Standard ist user.
notestringoptional
Eine optionale Notiz für die neue verantwortliche Person, bis zu 500 Zeichen.
Antwort
okbooleanoptional
Bei einer erfolgreichen Antwort immer true.
dataobjectoptional
keystringoptional
Der Schlüssel der Aufgabe im Format task:<id>.
assignmentIdstringoptional
Die ID der Zuweisung.
replacedintegeroptional
Wie viele bisherige verantwortliche Personen entfernt wurden. 0, wenn die Person bereits verantwortlich war.
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.
put/api/v1/work-management/tasks/{id}/owner
Ihr API-Schlüssel
id *
Anfragetext*
{}