Hämta en paginerad lista över automatiseringar för ett projekt med filtreringsalternativ
Lista alla Automatiseringar
Automatiseringar i Blue gör att du kan skapa kraftfulla arbetsflöden som utlöser åtgärder baserat på specifika händelser. Denna slutpunkt hämtar alla automatiseringar som är konfigurerade för ditt projekt, inklusive deras utlösare, åtgärder och nuvarande status.
Grundläggande Exempel
query ListAutomations {
automationList {
items {
id
isActive
trigger {
type
color
}
actions {
type
color
}
createdAt
}
pageInfo {
totalItems
hasNextPage
}
}
}
Avancerat Exempel
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
}
}
Indata Parametrar
Parameter |
Typ |
Obligatorisk |
Beskrivning |
customFieldIds |
[String] |
Nej |
Filtrera automatiseringar relaterade till specifika anpassade fält |
Paginering Parametrar
Parameter |
Typ |
Obligatorisk |
Beskrivning |
skip |
Int |
Nej |
Antal objekt att hoppa över (standard: 0) |
take |
Int |
Nej |
Antal objekt att returnera (standard: 20) |
Svarsfält
Fält |
Typ |
Beskrivning |
items |
[Automation!]! |
Lista över automatiseringsobjekt |
pageInfo |
PageInfo! |
Paginering information |
totalCount |
Int! |
Totalt antal automatiseringar |
Automation
Fält |
Typ |
Beskrivning |
id |
ID! |
Unik identifierare |
trigger |
AutomationTrigger! |
Händelsen som utlöser denna automatisering |
actions |
[AutomationAction!]! |
Åtgärder som utförs när den utlöses |
isActive |
Boolean! |
Om automatiseringen för närvarande är aktiv |
createdBy |
User! |
Användare som skapade automatiseringen |
project |
Project! |
Projekt som denna automatisering tillhör |
createdAt |
DateTime! |
Skapelsestämpel |
updatedAt |
DateTime! |
Senaste uppdateringsstämpel |
AutomationTrigger
Fält |
Typ |
Beskrivning |
id |
ID! |
Unik identifierare |
type |
AutomationTriggerType! |
Typ av utlösande händelse |
color |
String |
Relaterad färg (hex-format) |
metadata |
AutomationTriggerMetadata |
Utlösarspecifik konfiguration |
customField |
CustomField |
Relaterat anpassat fält (om tillämpligt) |
customFieldOptions |
[CustomFieldOption!] |
Valda alternativ för urvalsfält |
todos |
[CustomFieldReferenceTodo!] |
Refererade att-göra-punkter |
todoList |
TodoList |
Relaterad att-göra-lista |
tags |
[Tag!] |
Relaterade taggar |
assignees |
[User!] |
Relaterade tilldelningar |
AutomationAction
Fält |
Typ |
Beskrivning |
id |
ID! |
Unik identifierare |
type |
AutomationActionType! |
Typ av åtgärd att utföra |
color |
String |
Relaterad färg (hex-format) |
duedIn |
Int |
Dagar att lägga till för förfallodatumsåtgärder |
assigneeTriggerer |
String |
Speciell tilldelningsidentifierare |
metadata |
AutomationActionMetadata |
Åtgärdsspecifik konfiguration |
customField |
CustomField |
Mål anpassat fält |
customFieldOptions |
[CustomFieldOption!] |
Alternativ för urvalsfält |
todoList |
TodoList |
Mål att-göra-lista |
tags |
[Tag!] |
Taggar att lägga till/ta bort |
assignees |
[User!] |
Tilldelningar att lägga till/ta bort |
httpOption |
AutomationActionHttpOption |
HTTP begärningskonfiguration |
Utlösartyper
Typ |
Beskrivning |
TODO_CREATED |
När en ny post skapas |
TODO_LIST_CHANGED |
När en post flyttas mellan listor |
TODO_MARKED_AS_COMPLETE |
När en post slutförs |
TODO_MARKED_AS_INCOMPLETE |
När en post görs ofullständig |
ASSIGNEE_ADDED |
När en tilldelning läggs till |
ASSIGNEE_REMOVED |
När en tilldelning tas bort |
DUE_DATE_CHANGED |
När förfallodatumet ändras |
DUE_DATE_REMOVED |
När förfallodatumet rensas |
DUE_DATE_EXPIRED |
När förfallodatumet passerar |
TAG_ADDED |
När en tagg läggs till |
TAG_REMOVED |
När en tagg tas bort |
CHECKLIST_ITEM_MARKED_AS_DONE |
När en checklista-punkt slutförs |
CHECKLIST_ITEM_MARKED_AS_UNDONE |
När en checklista-punkt görs ofullständig |
TODO_COPIED_OR_MOVED_FROM_OTHER_PROJECT |
När posten importeras |
CUSTOM_FIELD_ADDED |
När värdet för det anpassade fältet sätts |
CUSTOM_FIELD_REMOVED |
När värdet för det anpassade fältet rensas |
CUSTOM_FIELD_BUTTON_CLICKED |
När knappläget klickas |
COLOR_ADDED |
När färg tillämpas |
COLOR_REMOVED |
När färg tas bort |
Åtgärdstyper
Typ |
Beskrivning |
CHANGE_TODO_LIST |
Flytta posten till en annan lista |
MARK_AS_COMPLETE |
Slutför posten |
MARK_AS_INCOMPLETE |
Gör posten ofullständig |
ADD_ASSIGNEE |
Lägg till tilldelning(ar) |
REMOVE_ASSIGNEE |
Ta bort tilldelning(ar) |
ADD_ASSIGNEE_TRIGGERER |
Lägg till användare som utlöste automatiseringen |
CHANGE_DUE_DATE |
Sätt eller uppdatera förfallodatum |
REMOVE_DUE_DATE |
Rensa förfallodatum |
ADD_TAG |
Tillämpa tagg(ar) |
REMOVE_TAG |
Ta bort tagg(ar) |
ADD_COLOR |
Tillämpa färg |
REMOVE_COLOR |
Ta bort färg |
ADD_CUSTOM_FIELD |
Sätt värde för anpassat fält |
REMOVE_CUSTOM_FIELD |
Rensa värde för anpassat fält |
CREATE_CHECKLIST |
Skapa ny checklista |
MARK_CHECKLIST_ITEM_AS_DONE |
Slutför checklistapunkter |
MARK_CHECKLIST_ITEM_AS_UNDONE |
Gör checklistapunkter ofullständiga |
COPY_TODO |
Duplicera posten |
SEND_EMAIL |
Skicka e-postmeddelande |
GENERATE_PDF |
Generera PDF-dokument |
MAKE_HTTP_REQUEST |
Anropa extern API |
Obligatoriska Behörigheter
Att lista automatiseringar kräver autentisering och projektåtkomst:
Roll |
Kan Lista Automatiseringar |
OWNER |
✅ Ja |
ADMIN |
✅ Ja |
MEMBER |
✅ Ja |
CLIENT |
✅ Ja |
Alla autentiserade användare med projektåtkomst kan se automatiseringar.
Fel Svar
Autentisering Krävs
{
"errors": [{
"message": "You must be logged in",
"extensions": {
"code": "UNAUTHENTICATED"
}
}]
}
Projekt Inte Hittat
{
"errors": [{
"message": "Project not found",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
Viktiga Anteckningar
- Ordning: Automatiseringar returneras alltid nyast först (efter skapelsedatum)
- Projektomfång: Automatiseringar är begränsade till den aktuella projektkontexten
- Aktiv Status: Kontrollera
isActive
för att avgöra om en automatisering för närvarande körs
- Metadata: Vissa utlösare och åtgärder har ytterligare metadata för konfiguration
- Prestanda: Använd paginering för projekt med många automatiseringar
- Filtrering: Stöder för närvarande endast filtrering efter anpassade fält-ID:n