특정 데이터 요소를 유지하면서 기존 레코드의 복사본을 만듭니다.


레코드 복사

기존 레코드의 복사본을 만들면서 특정 요소를 유지하려면 copyTodo 변이를 사용하세요:

mutation CopyTodo {
  copyTodo(
    input: {
      title: "new todo"
      todoId: "todo-id"
      todoListId: "todo-list-id"
      options: [
        DESCRIPTION
        DUE_DATE
        CHECKLISTS
        ASSIGNEES
        TAGS
        CUSTOM_FIELDS
        COMMENTS
      ]
    }
  )
}

필수 헤더

x-bloo-token-id: "your-token-id"
x-bloo-token-secret: "your-token-secret" 
x-bloo-project-id: "project-id-or-slug"
x-bloo-company-id: "company-id-or-slug"

입력 매개변수

필드 유형 필수 설명
title String 아니요 복사된 레코드의 새 제목 (선택 사항)
todoId String 복사할 레코드의 ID
todoListId String 복사본을 생성할 목록의 ID
options Array 원본 레코드에서 복사할 데이터 요소

복사 옵션

options 배열은 다음 값을 허용합니다:

옵션 설명
DESCRIPTION 레코드의 설명을 복사합니다
DUE_DATE 마감일과 시간대를 복사합니다
CHECKLISTS 모든 체크리스트와 항목을 복사합니다
ASSIGNEES 모든 할당된 사용자를 복사합니다 (대상 프로젝트 멤버십에 따라 필터링됨)
TAGS 모든 관련 태그를 복사합니다
CUSTOM_FIELDS 모든 사용자 정의 필드 값을 복사합니다 (파일 첨부 포함)
COMMENTS 모든 댓글과 답글을 복사합니다

예제 응답

{
  "data": {
    "copyTodo": true
  }
}
복사 위치

복사된 레코드는 기본적으로 대상 목록의 맨 아래에 배치됩니다. 위치를 제어하려면 [레코드 이동 변이](/api/records/move-record-list)를 사용하세요.
필수 권한

소스 및 대상 프로젝트 모두에서 편집 권한 (소유자, 관리자 또는 구성원 역할)이 필요합니다. 참고: 구성원 역할 사용자는 동일한 프로젝트 내에서만 레코드를 복사할 수 있습니다. 프로젝트 간 복사는 관리자 또는 소유자 권한이 필요합니다. 복사 실패 시 `FORBIDDEN` 오류 코드가 반환됩니다.

오류 처리

이 작업에 대한 일반적인 오류 코드:

  • TODO_NOT_FOUND: 유효하지 않거나 접근할 수 없는 todoId
  • TODO_LIST_NOT_FOUND: 유효하지 않거나 접근할 수 없는 todoListId
  • FORBIDDEN: 권한 부족 또는 프로젝트 간 제한

자세한 내용은 오류 코드를 참조하세요.

고급 기능

프로젝트 간 복사

이 변이는 다음과 같은 고려 사항으로 서로 다른 프로젝트 간에 레코드를 복사하는 것을 지원합니다:

  • 소유자/관리자: 접근할 수 있는 모든 프로젝트 간에 레코드를 복사할 수 있습니다.
  • 구성원: 동일한 프로젝트 내에서만 복사가 제한됩니다.
  • 담당자 필터링: 프로젝트 간 복사 시, 담당자는 자동으로 필터링되어 대상 프로젝트에 접근할 수 있는 사용자만 포함됩니다.

사용자 정의 필드 처리

CUSTOM_FIELDS 옵션을 사용할 때:

  • 모든 사용자 정의 필드 값이 새 레코드로 복사됩니다.
  • 사용자 정의 필드의 파일 첨부가 새로운 저장 참조와 함께 적절하게 복제됩니다.
  • 사용자 정의 필드 유형은 보존되며 대상 프로젝트의 구성에 대해 검증됩니다.

자동화 통합

프로젝트 간 복사는 소스 및 대상 프로젝트 모두에서 추가 자동화 규칙을 트리거할 수 있어 프로젝트 경계를 넘어 복잡한 워크플로우 관리를 가능하게 합니다.

AI 어시스턴트

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

어떻게 도와드릴까요?

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

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