Lär dig hur du uppdaterar postdetaljer och anpassade fält med hjälp av Blue API.


Uppdatera Postdetaljer

För att uppdatera en posts kärnegenskaper, använd editTodo mutation:

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

Referens för Inmatningsfält

Fält Typ Beskrivning
todoId String (Obligatoriskt) ID:t för posten som ska uppdateras
todoListId String Ny lista ID om posten flyttas
position Float Ny position i listan
title String Uppdaterad posttitel
html/text String Uppdaterad beskrivning (måste matcha i båda fälten)
startedAt/duedAt DateTime Uppdaterade start/slutdatum i ISO 8601-format
color String Färgkod från tillgängliga alternativ

Färgval

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

Uppdatera Anpassade Fält

För att uppdatera värden för anpassade fält, använd setTodoCustomField mutation med fältspecifika parametrar:

Textbaserade Fält

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

Gäller för: TEXT_SINGLE, TEXT_MULTI, URL, EMAIL

Numeriska Fält

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

Gäller för: NUMBER, PERCENT, RATING

Urvalsfält

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

Gäller för: SELECT_SINGLE, SELECT_MULTI

Specialiserade Fält

Telefonnummer:

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

Länder:

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

Plats:

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

Checkbox:

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

Obligatoriska Behörigheter

Användare måste ha lämplig projektåtkomst för att uppdatera poster:

Åtkomstnivå Kan Uppdatera Poster
OWNER ✅ Ja
ADMIN ✅ Ja
MEMBER ✅ Ja
CLIENT ✅ Ja
COMMENT_ONLY ❌ Nej
VIEW_ONLY ❌ Nej

Ytterligare behörigheter för anpassade fält kan gälla för setTodoCustomField baserat på rollkonfiguration.

Returvärden

  • editTodo returnerar det fullständigt uppdaterade Todo objektet
  • setTodoCustomField returnerar Boolean! som indikerar framgång

Noter

  1. ID:n för anpassade fält kan hittas med hjälp av frågan lista anpassade fält
  2. Telefonnummer måste vara i E.164-format när API:t används direkt
  3. Platsfält hanteras bäst genom Blue-appens gränssnitt
  4. Fälten html och text synkroniseras automatiskt när html tillhandahålls
  5. Alla uppdateringsoperationer utlöser aktivitetsloggning och webhook-notifikationer

AI-assistent

Svar genereras med hjälp av AI och kan innehålla misstag.

Hur kan jag hjälpa dig?

Fråga mig vad som helst om Blue eller denna dokumentation.

Tryck Enter för att skicka • Shift+Enter för ny rad • ⌘I för att öppna