v1Ressourcen/Approvals/getAufgabe abrufen
Aufgabe abrufen
Gibt eine Aufgabe oder Unteraufgabe aus Aufgaben & Freigaben anhand ihrer ID zurück: Status, verantwortliche Person, Freigabestatus, Termine und rowVersion. Eine Aufgabe, die nicht existiert oder zu einem Kunden außerhalb des Zugriffs des Schlüssels gehört, liefert 404. Ist Aufgaben & Freigaben für Ihren Workspace nicht aktiviert, wird 404 zurückgegeben.
get
approvals:read/api/v1/work-management/tasks/{id}Query-Parameter
idstringerforderlich
Die ID der Aufgabe, eine UUID. Jeder andere Wert liefert 404.
Antwort
okbooleanoptional
Bei einer erfolgreichen Antwort immer true.
deliveryAvailablebooleanoptional
Ob dieser Workspace freigegebene Inhalte zustellen kann. Kann fehlen.
itemobjectoptional
Die Aufgabe.
keystringoptional
Der Schlüssel der Aufgabe im Format task:<id>.
itemIdstringoptional
Die ID der Aufgabe.
kindstring (task | subtask)optional
task für eine Hauptaufgabe, subtask für eine Unteraufgabe.
titlestringoptional
Der Titel der Aufgabe.
descriptionstringoptional
Die Beschreibung der Aufgabe oder null.
statusstring (open | in_progress | awaiting_decision | approval_required | revision_requested | approved | rejected | done | dismissed)optional
Der aktuelle Stand der Aufgabe. approval_required bedeutet, dass sie auf ihren Freigebenden wartet.
clientIdstringoptional
Der Kunde der Aufgabe oder null für Agenturarbeit.
locationIdstringoptional
Der Standort, auf den sich die Aufgabe bezieht, oder null.
projectIdstringoptional
Das Projekt, zu dem die Aufgabe gehört, oder null.
projectNamestringoptional
Der Name des Projekts oder null.
parentKeystringoptional
Bei einer Unteraufgabe der Schlüssel der übergeordneten Aufgabe, sonst null.
ownersarray of objectoptional
Die verantwortliche Person der Aufgabe als Liste. Neue Aufgaben haben höchstens eine, ältere Aufgaben können noch mehrere anzeigen.
idstringoptional
Die ID der Person. Übergeben Sie sie als ownerId beim Erstellen einer Aufgabe oder als userId beim Festlegen einer verantwortlichen Person.
namestringoptional
Der Anzeigename der Person.
typestring (user | client_user)optional
user für ein Teammitglied der Agentur, client_user für eine Person eines Kunden. Senden Sie denselben Wert als ownerType.
avatarUrlstringoptional
Die URL des Profilbilds der Person, falls vorhanden.
creatorobjectoptional
Wer die Aufgabe erstellt hat: ein Teammitglied oder ein Kundenbenutzer. null, wenn unbekannt.
idstringoptional
namestringoptional
typestring (user | client_user)optional
manualApprovalobjectoptional
Der Freigebende der Aufgabe und der Stand ihrer Freigabeanfrage.
approverobjectoptional
ID, Name und Typ des Freigebenden oder null, wenn es keinen gibt.
statestring (approval_required | approved)optional
approval_required, solange eine Anfrage auf den Freigebenden wartet, approved nach der Freigabe, sonst null.
requestIdstringoptional
Die ID der offenen Freigabeanfrage oder null.
feedbackstringoptional
Die Begründung des Freigebenden, wenn Änderungen angefordert wurden, solange die Aufgabe wieder offen ist. Sonst null.
detailsobjectoptional
Labels, Startdatum, Zeitschätzung und angehängte Dateien.
labelsarray of stringoptional
startDatestringoptional
estimatedMinutesintegeroptional
attachmentsarray of objectoptional
keystringoptional
namestringoptional
mimestringoptional
sizeintegeroptional
prioritystring (urgent | high | medium | low)optional
Die Priorität der Aufgabe oder null.
dueAtstringoptional
Fälligkeit der Aufgabe in UTC oder null.
createdAtstringoptional
Erstellungszeitpunkt der Aufgabe in UTC.
updatedAtstringoptional
Zeitpunkt der letzten Änderung der Aufgabe in UTC.
completedAtstringoptional
Abschlusszeitpunkt der Aufgabe in UTC oder null.
blockedByarray of stringoptional
Schlüssel offener Elemente, die vor dieser Aufgabe erledigt sein müssen.
openSubtaskCountintegeroptional
Wie viele ihrer Unteraufgaben noch offen sind.
commentCountintegeroptional
Anzahl der Kommentare zur Aufgabe.
rowVersionintegeroptional
Die Versionsnummer der Aufgabe. Sie steigt bei jeder Bearbeitung der Aufgabe.
Fehler
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.
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.
get/api/v1/work-management/tasks/{id}
Ihr API-Schlüssel
id *
{}