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

AutomationFilterInput

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

AutomationPagination

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

AI Assistent

Antwoorden worden gegenereerd met behulp van AI en kunnen fouten bevatten.

Hoe kan ik u helpen?

Vraag me alles over Blue of deze documentatie.

Voer in om te verzenden • Shift+Enter voor nieuwe regel • ⌘I om te openen