필터링 옵션이 있는 프로젝트의 자동화 목록을 페이지네이션하여 가져옵니다.
모든 자동화 목록
Blue의 자동화를 사용하면 특정 이벤트에 따라 작업을 트리거하는 강력한 워크플로를 생성할 수 있습니다. 이 엔드포인트는 프로젝트에 구성된 모든 자동화(트리거, 작업 및 현재 상태 포함)를 검색합니다.
기본 예제
query ListAutomations {
automationList {
items {
id
isActive
trigger {
type
color
}
actions {
type
color
}
createdAt
}
pageInfo {
totalItems
hasNextPage
}
}
}
고급 예제
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
}
}
입력 매개변수
매개변수 |
유형 |
필수 |
설명 |
customFieldIds |
[String] |
아니오 |
특정 사용자 정의 필드와 관련된 자동화를 필터링합니다. |
페이지네이션 매개변수
매개변수 |
유형 |
필수 |
설명 |
skip |
Int |
아니오 |
건너뛸 항목 수 (기본값: 0) |
take |
Int |
아니오 |
반환할 항목 수 (기본값: 20) |
응답 필드
필드 |
유형 |
설명 |
items |
[Automation!]! |
자동화 객체 목록 |
pageInfo |
PageInfo! |
페이지네이션 정보 |
totalCount |
Int! |
총 자동화 수 |
Automation
필드 |
유형 |
설명 |
id |
ID! |
고유 식별자 |
trigger |
AutomationTrigger! |
이 자동화를 트리거하는 이벤트 |
actions |
[AutomationAction!]! |
트리거 시 수행되는 작업 |
isActive |
Boolean! |
자동화가 현재 활성화되어 있는지 여부 |
createdBy |
User! |
자동화를 생성한 사용자 |
project |
Project! |
이 자동화가 속한 프로젝트 |
createdAt |
DateTime! |
생성 타임스탬프 |
updatedAt |
DateTime! |
마지막 업데이트 타임스탬프 |
AutomationTrigger
필드 |
유형 |
설명 |
id |
ID! |
고유 식별자 |
type |
AutomationTriggerType! |
트리거 이벤트 유형 |
color |
String |
관련 색상 (16진수 형식) |
metadata |
AutomationTriggerMetadata |
트리거별 구성 |
customField |
CustomField |
관련 사용자 정의 필드 (해당되는 경우) |
customFieldOptions |
[CustomFieldOption!] |
선택 필드에 대한 선택된 옵션 |
todos |
[CustomFieldReferenceTodo!] |
참조된 할 일 |
todoList |
TodoList |
관련 할 일 목록 |
tags |
[Tag!] |
관련 태그 |
assignees |
[User!] |
관련 담당자 |
AutomationAction
필드 |
유형 |
설명 |
id |
ID! |
고유 식별자 |
type |
AutomationActionType! |
수행할 작업 유형 |
color |
String |
관련 색상 (16진수 형식) |
duedIn |
Int |
기한 날짜 작업을 위한 추가할 일수 |
assigneeTriggerer |
String |
특별한 담당자 식별자 |
metadata |
AutomationActionMetadata |
작업별 구성 |
customField |
CustomField |
대상 사용자 정의 필드 |
customFieldOptions |
[CustomFieldOption!] |
선택 필드에 대한 옵션 |
todoList |
TodoList |
대상 할 일 목록 |
tags |
[Tag!] |
추가/제거할 태그 |
assignees |
[User!] |
추가/제거할 담당자 |
httpOption |
AutomationActionHttpOption |
HTTP 요청 구성 |
트리거 유형
유형 |
설명 |
TODO_CREATED |
새 레코드가 생성될 때 |
TODO_LIST_CHANGED |
레코드가 목록 간에 이동할 때 |
TODO_MARKED_AS_COMPLETE |
레코드가 완료될 때 |
TODO_MARKED_AS_INCOMPLETE |
레코드가 미완료될 때 |
ASSIGNEE_ADDED |
담당자가 추가될 때 |
ASSIGNEE_REMOVED |
담당자가 제거될 때 |
DUE_DATE_CHANGED |
기한 날짜가 수정될 때 |
DUE_DATE_REMOVED |
기한 날짜가 지워질 때 |
DUE_DATE_EXPIRED |
기한 날짜가 지나갈 때 |
TAG_ADDED |
태그가 추가될 때 |
TAG_REMOVED |
태그가 제거될 때 |
CHECKLIST_ITEM_MARKED_AS_DONE |
체크리스트 항목이 완료될 때 |
CHECKLIST_ITEM_MARKED_AS_UNDONE |
체크리스트 항목이 미완료될 때 |
TODO_COPIED_OR_MOVED_FROM_OTHER_PROJECT |
레코드가 가져올 때 |
CUSTOM_FIELD_ADDED |
사용자 정의 필드 값이 설정될 때 |
CUSTOM_FIELD_REMOVED |
사용자 정의 필드 값이 지워질 때 |
CUSTOM_FIELD_BUTTON_CLICKED |
버튼 필드가 클릭될 때 |
COLOR_ADDED |
색상이 적용될 때 |
COLOR_REMOVED |
색상이 제거될 때 |
작업 유형
유형 |
설명 |
CHANGE_TODO_LIST |
레코드를 다른 목록으로 이동 |
MARK_AS_COMPLETE |
레코드를 완료 |
MARK_AS_INCOMPLETE |
레코드를 미완료 |
ADD_ASSIGNEE |
담당자 추가 |
REMOVE_ASSIGNEE |
담당자 제거 |
ADD_ASSIGNEE_TRIGGERER |
자동화를 트리거한 사용자 추가 |
CHANGE_DUE_DATE |
기한 날짜 설정 또는 업데이트 |
REMOVE_DUE_DATE |
기한 날짜 지우기 |
ADD_TAG |
태그 적용 |
REMOVE_TAG |
태그 제거 |
ADD_COLOR |
색상 적용 |
REMOVE_COLOR |
색상 제거 |
ADD_CUSTOM_FIELD |
사용자 정의 필드 값 설정 |
REMOVE_CUSTOM_FIELD |
사용자 정의 필드 값 지우기 |
CREATE_CHECKLIST |
새 체크리스트 생성 |
MARK_CHECKLIST_ITEM_AS_DONE |
체크리스트 항목 완료 |
MARK_CHECKLIST_ITEM_AS_UNDONE |
체크리스트 항목 미완료 |
COPY_TODO |
레코드 복제 |
SEND_EMAIL |
이메일 알림 전송 |
GENERATE_PDF |
PDF 문서 생성 |
MAKE_HTTP_REQUEST |
외부 API 호출 |
필수 권한
자동화 목록을 보려면 인증 및 프로젝트 접근이 필요합니다:
역할 |
자동화 목록 보기 가능 |
OWNER |
✅ 예 |
ADMIN |
✅ 예 |
MEMBER |
✅ 예 |
CLIENT |
✅ 예 |
모든 인증된 사용자는 프로젝트 접근이 있는 경우 자동화를 볼 수 있습니다.
오류 응답
인증 필요
{
"errors": [{
"message": "You must be logged in",
"extensions": {
"code": "UNAUTHENTICATED"
}
}]
}
프로젝트를 찾을 수 없음
{
"errors": [{
"message": "Project not found",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
중요 사항
- 정렬: 자동화는 항상 최신 순으로 반환됩니다 (생성 날짜 기준)
- 프로젝트 범위: 자동화는 현재 프로젝트 컨텍스트에 한정됩니다
- 활성 상태: 자동화가 현재 실행 중인지 확인하려면
isActive
를 확인하세요
- 메타데이터: 일부 트리거 및 작업에는 구성용 추가 메타데이터가 있습니다
- 성능: 많은 자동화가 있는 프로젝트에는 페이지네이션을 사용하세요
- 필터링: 현재는 사용자 정의 필드 ID로만 필터링을 지원합니다