Eine paginierte Liste von Automatisierungen für ein Projekt mit Filteroptionen abrufen
Alle Automatisierungen auflisten
Automatisierungen in Blue ermöglichen es Ihnen, leistungsstarke Workflows zu erstellen, die Aktionen basierend auf bestimmten Ereignissen auslösen. Dieser Endpunkt ruft alle für Ihr Projekt konfigurierten Automatisierungen ab, einschließlich ihrer Auslöser, Aktionen und aktuellen Status.
Einfaches Beispiel
query ListAutomations {
automationList {
items {
id
isActive
trigger {
type
color
}
actions {
type
color
}
createdAt
}
pageInfo {
totalItems
hasNextPage
}
}
}
Fortgeschrittenes Beispiel
query ListAutomationsAdvanced {
automationList(
filter: {
customFieldIds: ["field_123", "field_456"]
}
skip: 0
take: 50
) {
items {
id
isActive
createdAt
updatedAt
# Trigger details
trigger {
id
type
color
metadata {
... on AutomationTriggerMetadataTodoOverdue {
incompleteOnly
}
}
customField {
id
name
type
}
customFieldOptions {
id
title
color
}
todoList {
id
title
}
tags {
id
title
color
}
assignees {
id
name
email
}
}
# Action details
actions {
id
type
color
duedIn
assigneeTriggerer
# Action-specific fields
customField {
id
name
}
customFieldOptions {
id
title
}
todoList {
id
title
}
tags {
id
title
}
assignees {
id
name
}
# Email action metadata
metadata {
... on AutomationActionMetadataSendEmail {
email {
subject
to
from
content
}
}
... on AutomationActionMetadataCreateChecklist {
checklists {
title
checklistItems {
title
duedIn
}
}
}
}
}
# Creator info
createdBy {
id
name
email
}
}
pageInfo {
totalItems
totalPages
hasNextPage
hasPreviousPage
}
totalCount
}
}
Eingabeparameter
Parameter |
Typ |
Erforderlich |
Beschreibung |
customFieldIds |
[String] |
Nein |
Filtert Automatisierungen, die mit bestimmten benutzerdefinierten Feldern verbunden sind |
Paginierungsparameter
Parameter |
Typ |
Erforderlich |
Beschreibung |
skip |
Int |
Nein |
Anzahl der zu überspringenden Elemente (Standard: 0) |
take |
Int |
Nein |
Anzahl der zurückzugebenden Elemente (Standard: 20) |
Antwortfelder
Feld |
Typ |
Beschreibung |
items |
[Automation!]! |
Liste von Automatisierungsobjekten |
pageInfo |
PageInfo! |
Paginierungsinformationen |
totalCount |
Int! |
Gesamtanzahl der Automatisierungen |
Automation
Feld |
Typ |
Beschreibung |
id |
ID! |
Eindeutige Kennung |
trigger |
AutomationTrigger! |
Das Ereignis, das diese Automatisierung auslöst |
actions |
[AutomationAction!]! |
Aktionen, die bei Auslösung durchgeführt werden |
isActive |
Boolean! |
Ob die Automatisierung derzeit aktiv ist |
createdBy |
User! |
Benutzer, der die Automatisierung erstellt hat |
project |
Project! |
Projekt, zu dem diese Automatisierung gehört |
createdAt |
DateTime! |
Erstellungszeitstempel |
updatedAt |
DateTime! |
Letzter Aktualisierungszeitstempel |
AutomationTrigger
Feld |
Typ |
Beschreibung |
id |
ID! |
Eindeutige Kennung |
type |
AutomationTriggerType! |
Art des Auslöserereignisses |
color |
String |
Zugehörige Farbe (Hex-Format) |
metadata |
AutomationTriggerMetadata |
Auslöserspezifische Konfiguration |
customField |
CustomField |
Zugehöriges benutzerdefiniertes Feld (falls zutreffend) |
customFieldOptions |
[CustomFieldOption!] |
Ausgewählte Optionen für Auswahlfelder |
todos |
[CustomFieldReferenceTodo!] |
Referenzierte Todos |
todoList |
TodoList |
Zugehörige To-do-Liste |
tags |
[Tag!] |
Zugehörige Tags |
assignees |
[User!] |
Zugehörige Zuweisungen |
AutomationAction
Feld |
Typ |
Beschreibung |
id |
ID! |
Eindeutige Kennung |
type |
AutomationActionType! |
Art der auszuführenden Aktion |
color |
String |
Zugehörige Farbe (Hex-Format) |
duedIn |
Int |
Tage, die für Fälligkeitsdatum-Aktionen hinzugefügt werden sollen |
assigneeTriggerer |
String |
Besondere Zuweisungskennung |
metadata |
AutomationActionMetadata |
Aktionsspezifische Konfiguration |
customField |
CustomField |
Zielbenutzerdefiniertes Feld |
customFieldOptions |
[CustomFieldOption!] |
Optionen für Auswahlfelder |
todoList |
TodoList |
Ziel-To-do-Liste |
tags |
[Tag!] |
Tags hinzufügen/entfernen |
assignees |
[User!] |
Zuweisungen hinzufügen/entfernen |
httpOption |
AutomationActionHttpOption |
HTTP-Anforderungs-Konfiguration |
Auslöserarten
Typ |
Beschreibung |
TODO_CREATED |
Wenn ein neuer Datensatz erstellt wird |
TODO_LIST_CHANGED |
Wenn ein Datensatz zwischen Listen verschoben wird |
TODO_MARKED_AS_COMPLETE |
Wenn ein Datensatz abgeschlossen wird |
TODO_MARKED_AS_INCOMPLETE |
Wenn ein Datensatz nicht abgeschlossen wird |
ASSIGNEE_ADDED |
Wenn ein Zuweiser hinzugefügt wird |
ASSIGNEE_REMOVED |
Wenn ein Zuweiser entfernt wird |
DUE_DATE_CHANGED |
Wenn das Fälligkeitsdatum geändert wird |
DUE_DATE_REMOVED |
Wenn das Fälligkeitsdatum gelöscht wird |
DUE_DATE_EXPIRED |
Wenn das Fälligkeitsdatum überschritten wird |
TAG_ADDED |
Wenn ein Tag hinzugefügt wird |
TAG_REMOVED |
Wenn ein Tag entfernt wird |
CHECKLIST_ITEM_MARKED_AS_DONE |
Wenn ein Checklistenpunkt abgeschlossen wird |
CHECKLIST_ITEM_MARKED_AS_UNDONE |
Wenn ein Checklistenpunkt nicht abgeschlossen wird |
TODO_COPIED_OR_MOVED_FROM_OTHER_PROJECT |
Wenn ein Datensatz importiert wird |
CUSTOM_FIELD_ADDED |
Wenn der Wert eines benutzerdefinierten Feldes festgelegt wird |
CUSTOM_FIELD_REMOVED |
Wenn der Wert eines benutzerdefinierten Feldes gelöscht wird |
CUSTOM_FIELD_BUTTON_CLICKED |
Wenn das Schaltflächenfeld angeklickt wird |
COLOR_ADDED |
Wenn eine Farbe angewendet wird |
COLOR_REMOVED |
Wenn eine Farbe entfernt wird |
Aktionsarten
Typ |
Beschreibung |
CHANGE_TODO_LIST |
Datensatz in eine andere Liste verschieben |
MARK_AS_COMPLETE |
Den Datensatz abschließen |
MARK_AS_INCOMPLETE |
Den Datensatz nicht abschließen |
ADD_ASSIGNEE |
Zuweiser hinzufügen |
REMOVE_ASSIGNEE |
Zuweiser entfernen |
ADD_ASSIGNEE_TRIGGERER |
Benutzer hinzufügen, der die Automatisierung ausgelöst hat |
CHANGE_DUE_DATE |
Fälligkeitsdatum festlegen oder aktualisieren |
REMOVE_DUE_DATE |
Fälligkeitsdatum löschen |
ADD_TAG |
Tag(s) anwenden |
REMOVE_TAG |
Tag(s) entfernen |
ADD_COLOR |
Farbe anwenden |
REMOVE_COLOR |
Farbe entfernen |
ADD_CUSTOM_FIELD |
Wert eines benutzerdefinierten Feldes festlegen |
REMOVE_CUSTOM_FIELD |
Wert eines benutzerdefinierten Feldes löschen |
CREATE_CHECKLIST |
Neue Checkliste erstellen |
MARK_CHECKLIST_ITEM_AS_DONE |
Checklistenpunkte abschließen |
MARK_CHECKLIST_ITEM_AS_UNDONE |
Checklistenpunkte nicht abschließen |
COPY_TODO |
Den Datensatz duplizieren |
SEND_EMAIL |
E-Mail-Benachrichtigung senden |
GENERATE_PDF |
PDF-Dokument generieren |
MAKE_HTTP_REQUEST |
Externe API aufrufen |
Erforderliche Berechtigungen
Das Auflisten von Automatisierungen erfordert Authentifizierung und Projektzugriff:
Rolle |
Kann Automatisierungen auflisten |
OWNER |
✅ Ja |
ADMIN |
✅ Ja |
MEMBER |
✅ Ja |
CLIENT |
✅ Ja |
Alle authentifizierten Benutzer mit Projektzugriff können Automatisierungen anzeigen.
Fehlerantworten
Authentifizierung erforderlich
{
"errors": [{
"message": "You must be logged in",
"extensions": {
"code": "UNAUTHENTICATED"
}
}]
}
Projekt nicht gefunden
{
"errors": [{
"message": "Project not found",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
Wichtige Hinweise
- Reihenfolge: Automatisierungen werden immer neueste zuerst zurückgegeben (nach Erstellungsdatum)
- Projektbereich: Automatisierungen sind auf den aktuellen Projektkontext beschränkt
- Aktiver Status: Überprüfen Sie
isActive
, um festzustellen, ob eine Automatisierung derzeit läuft
- Metadaten: Einige Auslöser und Aktionen haben zusätzliche Metadaten zur Konfiguration
- Leistung: Verwenden Sie die Paginierung für Projekte mit vielen Automatisierungen
- Filterung: Derzeit wird nur die Filterung nach benutzerdefinierten Feld-IDs unterstützt