필터링 옵션이 있는 프로젝트의 자동화 목록을 페이지네이션하여 가져옵니다.


모든 자동화 목록

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
  }
}

입력 매개변수

AutomationFilterInput

매개변수 유형 필수 설명
customFieldIds [String] 아니오 특정 사용자 정의 필드와 관련된 자동화를 필터링합니다.

페이지네이션 매개변수

매개변수 유형 필수 설명
skip Int 아니오 건너뛸 항목 수 (기본값: 0)
take Int 아니오 반환할 항목 수 (기본값: 20)

응답 필드

AutomationPagination

필드 유형 설명
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로만 필터링을 지원합니다

AI 어시스턴트

응답은 AI를 사용하여 생성되며 오류가 포함될 수 있습니다.

어떻게 도와드릴까요?

Blue 또는 이 문서에 대해 궁금한 점이 있으면 무엇이든 물어보세요.

전송하려면 Enter • 새 줄을 추가하려면 Shift+Enter • ⌘I를 눌러 열기