Synup
Schlüssel erstellen
v1Ressourcen/Approvals/putVerantwortliche Person einer Aufgabe festlegen

Verantwortliche Person einer Aufgabe festlegen

Macht eine Person zur verantwortlichen Person einer Aufgabe und ersetzt die bisherige. Jede entfernte Person bleibt im Verlauf der Aufgabe erhalten, und sowohl die bisherige als auch die neue verantwortliche Person erhalten eine Benachrichtigung. Mit GET /api/v1/work-management/owners finden Sie heraus, wer infrage kommt. Ein Kundenbenutzer kann nur dann verantwortlich sein, wenn die Aufgabe einen Kunden hat, und nur als Kundenbenutzer dieses Kunden. Eine Änderung, während die Aufgabe auf Freigabe wartet, liefert 409. Ziehen Sie die Freigabeanfrage also zuerst zurück. Eine Aufgabe außerhalb des Kundenzugriffs des Schlüssels liefert 403. Wiederholungen mit demselben idempotencyKey und Body liefern das erste Ergebnis mit replayed auf true. Ist Aufgaben & Freigaben für Ihren Workspace nicht aktiviert, wird 404 zurückgegeben.

put/api/v1/work-management/tasks/{id}/owner
approvals:write
Query-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*
{}

Neu bei der Synup-API?