---

Actualizar Detalles del Registro

Para actualizar las propiedades principales de un registro, use la mutación 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
  }
}

Referencia de Campos de Entrada

Campo	Tipo	Descripción
todoId	String	(Requerido) El ID del registro a actualizar
todoListId	String	Nuevo ID de lista si se mueve el registro
position	Float	Nueva posición en la lista
title	String	Título del registro actualizado
html/text	String	Descripción actualizada (debe coincidir en ambos campos)
startedAt/duedAt	DateTime	Fechas de inicio/fin actualizadas en formato ISO 8601
color	String	Código de color de las opciones disponibles

Opciones de Color

// 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"]

Actualizar Campos Personalizados

Para actualizar los valores de los campos personalizados, use la mutación setTodoCustomField con parámetros específicos del campo:

Campos Basados en Texto

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

Aplica a: TEXT_SINGLE, TEXT_MULTI, URL, EMAIL

Campos Numéricos

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

Aplica a: NUMBER, PERCENT, RATING

Campos de Selección

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

Aplica a: SELECT_SINGLE, SELECT_MULTI

Campos Especializados

Números de Teléfono:

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

Países:

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

Ubicación:

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

Casilla de Verificación:

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

Permisos Requeridos

Los usuarios deben tener acceso adecuado al proyecto para actualizar registros:

Nivel de Acceso	Puede Actualizar Registros
OWNER	✅ Sí
ADMIN	✅ Sí
MEMBER	✅ Sí
CLIENT	✅ Sí
COMMENT_ONLY	❌ No
VIEW_ONLY	❌ No

Pueden aplicarse permisos adicionales de campos personalizados para setTodoCustomField según la configuración del rol.

Valores de Retorno

• editTodo devuelve el objeto Todo actualizado completo
• setTodoCustomField devuelve Boolean! indicando éxito

Notas

1. Los IDs de los campos personalizados se pueden encontrar utilizando la consulta listar campos personalizados
2. Los números de teléfono deben estar en formato E.164 al usar la API directamente
3. Los campos de ubicación se gestionan mejor a través de la interfaz de la aplicación Blue
4. Los campos html y text se sincronizan automáticamente cuando se proporciona html
5. Todas las operaciones de actualización activan el registro de actividades y las notificaciones de webhook