---

레코드 세부정보 업데이트

레코드의 핵심 속성을 업데이트하려면 editTodo 변이를 사용하세요:

mutation UpdateRecordDetails {
  editTodo(
    input: {
      todoId: "YOUR RECORD ID"
      todoListId: "RECORD LIST ID TO MOVE THE RECORD TO"
      position: "NEW RECORD POSITION IN NUMBER"
      title: "NEW RECORD TITLE"
      html: "NEW RECORD DESCRIPTION IN HTML (MUST MATCH TEXT)"
      text: "NEW RECORD DESCRIPTION IN TEXT (MUST MATCH HTML)"
      startedAt: "NEW RECORD DUE DATE (START)"
      duedAt: "NEW RECORD DUE DATE (END)"
      color: "RECORD COLOR CODE"
    }
  ) {
    id
    title
    position
    html
    text
    color
  }
}

입력 필드 참조

필드	유형	설명
todoId	String	(필수) 업데이트할 레코드의 ID
todoListId	String	레코드를 이동할 경우 새 목록 ID
position	Float	목록에서의 새 위치
title	String	업데이트된 레코드 제목
html/text	String	업데이트된 설명(두 필드에서 일치해야 함)
startedAt/duedAt	DateTime	업데이트된 시작/종료 날짜 (ISO 8601 형식)
color	String	사용 가능한 옵션에서의 색상 코드

색상 옵션

// Light theme colors
["#ffc2d4", "#ed8285", "#ffb55e", "#ffe885", "#ccf07d", 
 "#91e38c", "#a1f7fa", "#91cfff", "#c29ee0", "#e8bd91"]

// Dark theme colors  
["#ff8ebe", "#ff4b4b", "#ff9e4b", "#ffdc6b", "#b4e051",
 "#66d37e", "#4fd2ff", "#4a9fff", "#a17ee8", "#e89e64"]

사용자 정의 필드 업데이트

사용자 정의 필드 값을 업데이트하려면 필드별 매개변수와 함께 setTodoCustomField 변이를 사용하세요:

텍스트 기반 필드

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID"
      text: "VALUE"
    }
  )
}

적용 대상: TEXT_SINGLE, TEXT_MULTI, URL, EMAIL

숫자 필드

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID" 
      number: "NUMERIC_VALUE"
    }
  )
}

적용 대상: NUMBER, PERCENT, RATING

선택 필드

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID"
      customFieldOptionIds: ["OPTION_ID_1", "OPTION_ID_2"]
    }
  )
}

적용 대상: SELECT_SINGLE, SELECT_MULTI

전문화된 필드

전화번호:

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID"
      text: "+33642526644"
      regionCode: "FR"
    }
  )
}

국가:

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID"
      countryCodes: ["AF", "AL", "DZ"]
      text: "Afghanistan, Albania, Algeria"
    }
  )
}

위치:

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID"
      latitude: 42.2923323
      longitude: 12.126621199999999
      text: "Via Cassia, Querce d'Orlando, Capranica, Italy"
    }
  )
}

체크박스:

mutation {
  setTodoCustomField(
    input: {
      customFieldId: "YOUR CUSTOM FIELD ID"
      todoId: "YOUR RECORD ID"
      checked: true
    }
  )
}

필수 권한

사용자는 레코드를 업데이트하기 위해 적절한 프로젝트 접근 권한을 가져야 합니다:

접근 수준	레코드 업데이트 가능
OWNER	✅ 예
ADMIN	✅ 예
MEMBER	✅ 예
CLIENT	✅ 예
COMMENT_ONLY	❌ 아니오
VIEW_ONLY	❌ 아니오

추가 사용자 정의 필드 권한은 역할 구성에 따라 setTodoCustomField에 적용될 수 있습니다.

반환 값

• editTodo는 완전하게 업데이트된 Todo 객체를 반환합니다.
• setTodoCustomField는 성공을 나타내는 Boolean!를 반환합니다.

참고 사항

1. 사용자 정의 필드 ID는 사용자 정의 필드 목록 쿼리를 사용하여 찾을 수 있습니다.
2. 전화번호는 API를 직접 사용할 때 E.164 형식이어야 합니다.
3. 위치 필드는 Blue 앱 인터페이스를 통해 관리하는 것이 가장 좋습니다.
4. html 및 text 필드는 html가 제공될 때 자동으로 동기화됩니다.
5. 모든 업데이트 작업은 활동 로그와 웹훅 알림을 트리거합니다.