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 uppdateradeTodo
objektetsetTodoCustomField
returnerarBoolean!
som indikerar framgång
Noter
- ID:n för anpassade fält kan hittas med hjälp av frågan lista anpassade fält
- Telefonnummer måste vara i E.164-format när API:t används direkt
- Platsfält hanteras bäst genom Blue-appens gränssnitt
- Fälten
html
ochtext
synkroniseras automatiskt närhtml
tillhandahålls - Alla uppdateringsoperationer utlöser aktivitetsloggning och webhook-notifikationer