Haal een gepagineerde lijst van automatiseringen voor een project op met filteropties
Lijst alle Automatiseringen
Automatiseringen in Blue stellen je in staat om krachtige workflows te creëren die acties activeren op basis van specifieke gebeurtenissen. Dit eindpunt haalt alle automatiseringen op die voor je project zijn geconfigureerd, inclusief hun triggers, acties en huidige status.
Basisvoorbeeld
query ListAutomations {
automationList {
items {
id
isActive
trigger {
type
color
}
actions {
type
color
}
createdAt
}
pageInfo {
totalItems
hasNextPage
}
}
}
Geavanceerd Voorbeeld
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
}
}
Invoervariabelen
Parameter |
Type |
Vereist |
Beschrijving |
customFieldIds |
[String] |
Nee |
Filter automatiseringen gerelateerd aan specifieke aangepaste velden |
Paginering Parameters
Parameter |
Type |
Vereist |
Beschrijving |
skip |
Int |
Nee |
Aantal items om over te slaan (standaard: 0) |
take |
Int |
Nee |
Aantal items om terug te geven (standaard: 20) |
Responsvelden
Veld |
Type |
Beschrijving |
items |
[Automation!]! |
Lijst van automatiseringsobjecten |
pageInfo |
PageInfo! |
Paginainformatie |
totalCount |
Int! |
Totaal aantal automatiseringen |
Automatisering
Veld |
Type |
Beschrijving |
id |
ID! |
Unieke identificatie |
trigger |
AutomationTrigger! |
De gebeurtenis die deze automatisering activeert |
actions |
[AutomationAction!]! |
Acties die worden uitgevoerd wanneer deze wordt geactiveerd |
isActive |
Boolean! |
Of de automatisering momenteel actief is |
createdBy |
User! |
Gebruiker die de automatisering heeft gemaakt |
project |
Project! |
Project waartoe deze automatisering behoort |
createdAt |
DateTime! |
Tijdstempel van creatie |
updatedAt |
DateTime! |
Tijdstempel van laatste update |
AutomationTrigger
Veld |
Type |
Beschrijving |
id |
ID! |
Unieke identificatie |
type |
AutomationTriggerType! |
Type van triggergebeurtenis |
color |
String |
Geassocieerde kleur (hex-formaat) |
metadata |
AutomationTriggerMetadata |
Trigger-specifieke configuratie |
customField |
CustomField |
Gerelateerd aangepast veld (indien van toepassing) |
customFieldOptions |
[CustomFieldOption!] |
Geselecteerde opties voor selectievakken |
todos |
[CustomFieldReferenceTodo!] |
Verwezen taken |
todoList |
TodoList |
Gerelateerde takenlijst |
tags |
[Tag!] |
Gerelateerde tags |
assignees |
[User!] |
Gerelateerde toegewezen personen |
AutomationAction
Veld |
Type |
Beschrijving |
id |
ID! |
Unieke identificatie |
type |
AutomationActionType! |
Type actie om uit te voeren |
color |
String |
Geassocieerde kleur (hex-formaat) |
duedIn |
Int |
Dagen toe te voegen voor vervaldatumacties |
assigneeTriggerer |
String |
Speciale toegewezen identificatie |
metadata |
AutomationActionMetadata |
Actie-specifieke configuratie |
customField |
CustomField |
Doel aangepast veld |
customFieldOptions |
[CustomFieldOption!] |
Opties voor selectievakken |
todoList |
TodoList |
Doel takenlijst |
tags |
[Tag!] |
Tags om toe te voegen/verwijderen |
assignees |
[User!] |
Toegewezen personen om toe te voegen/verwijderen |
httpOption |
AutomationActionHttpOption |
HTTP-verzoekconfiguratie |
Trigger Types
Type |
Beschrijving |
TODO_CREATED |
Wanneer een nieuw record wordt aangemaakt |
TODO_LIST_CHANGED |
Wanneer een record tussen lijsten beweegt |
TODO_MARKED_AS_COMPLETE |
Wanneer een record is voltooid |
TODO_MARKED_AS_INCOMPLETE |
Wanneer een record niet is voltooid |
ASSIGNEE_ADDED |
Wanneer een toegewezen persoon wordt toegevoegd |
ASSIGNEE_REMOVED |
Wanneer een toegewezen persoon wordt verwijderd |
DUE_DATE_CHANGED |
Wanneer de vervaldatum wordt gewijzigd |
DUE_DATE_REMOVED |
Wanneer de vervaldatum wordt gewist |
DUE_DATE_EXPIRED |
Wanneer de vervaldatum verstrijkt |
TAG_ADDED |
Wanneer een tag wordt toegevoegd |
TAG_REMOVED |
Wanneer een tag wordt verwijderd |
CHECKLIST_ITEM_MARKED_AS_DONE |
Wanneer een checklistitem is voltooid |
CHECKLIST_ITEM_MARKED_AS_UNDONE |
Wanneer een checklistitem niet is voltooid |
TODO_COPIED_OR_MOVED_FROM_OTHER_PROJECT |
Wanneer een record wordt geïmporteerd |
CUSTOM_FIELD_ADDED |
Wanneer de waarde van een aangepast veld is ingesteld |
CUSTOM_FIELD_REMOVED |
Wanneer de waarde van een aangepast veld is gewist |
CUSTOM_FIELD_BUTTON_CLICKED |
Wanneer een knopveld wordt aangeklikt |
COLOR_ADDED |
Wanneer kleur wordt toegepast |
COLOR_REMOVED |
Wanneer kleur wordt verwijderd |
Actietypes
Type |
Beschrijving |
CHANGE_TODO_LIST |
Verplaats record naar een andere lijst |
MARK_AS_COMPLETE |
Voltooi het record |
MARK_AS_INCOMPLETE |
Maak het record niet voltooid |
ADD_ASSIGNEE |
Voeg toegewezen persoon/personen toe |
REMOVE_ASSIGNEE |
Verwijder toegewezen persoon/personen |
ADD_ASSIGNEE_TRIGGERER |
Voeg gebruiker toe die automatisering heeft geactiveerd |
CHANGE_DUE_DATE |
Stel of werk vervaldatum bij |
REMOVE_DUE_DATE |
Wis vervaldatum |
ADD_TAG |
Pas tag(s) toe |
REMOVE_TAG |
Verwijder tag(s) |
ADD_COLOR |
Pas kleur toe |
REMOVE_COLOR |
Verwijder kleur |
ADD_CUSTOM_FIELD |
Stel waarde van aangepast veld in |
REMOVE_CUSTOM_FIELD |
Wis waarde van aangepast veld |
CREATE_CHECKLIST |
Maak nieuwe checklist aan |
MARK_CHECKLIST_ITEM_AS_DONE |
Voltooi checklistitems |
MARK_CHECKLIST_ITEM_AS_UNDONE |
Maak checklistitems niet voltooid |
COPY_TODO |
Dupliceer het record |
SEND_EMAIL |
Stuur e-mailmelding |
GENERATE_PDF |
Genereer PDF-document |
MAKE_HTTP_REQUEST |
Roep externe API aan |
Vereiste Machtigingen
Het opsommen van automatiseringen vereist authenticatie en projecttoegang:
Rol |
Kan Automatiseringen Lijsten |
OWNER |
✅ Ja |
ADMIN |
✅ Ja |
MEMBER |
✅ Ja |
CLIENT |
✅ Ja |
Alle geauthenticeerde gebruikers met projecttoegang kunnen automatiseringen bekijken.
Foutreacties
Authenticatie Vereist
{
"errors": [{
"message": "You must be logged in",
"extensions": {
"code": "UNAUTHENTICATED"
}
}]
}
Project Niet Gevonden
{
"errors": [{
"message": "Project not found",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
Belangrijke Notities
- Volgorde: Automatiseringen worden altijd het nieuwste eerst teruggegeven (op basis van de creatiedatum)
- Projectscope: Automatiseringen zijn beperkt tot de huidige projectcontext
- Actieve Status: Controleer
isActive
om te bepalen of een automatisering momenteel actief is
- Metadata: Sommige triggers en acties hebben aanvullende metadata voor configuratie
- Prestaties: Gebruik paginering voor projecten met veel automatiseringen
- Filtering: Ondersteunt momenteel alleen filtering op basis van aangepaste veld-ID's