Växla en post mellan fullständig och ofullständig status med en enda mutation.


Växla Poststatus

Mutation updateTodoDoneStatus ger ett enkelt sätt att växla en posts fullständighetsstatus. Om posten är ofullständig, markerar den den som fullständig. Om den är fullständig, markerar den den som ofullständig.

Exempel

mutation ToggleRecordStatus {
  updateTodoDoneStatus(todoId: "todo_123") {
    id
    title
    done
    updatedAt
  }
}

Indata Parametrar

Parameter Typ Obligatorisk Beskrivning
todoId String! ✅ Ja ID för posten som ska växlas

Svar

Returnerar det uppdaterade Todo objektet med alla tillgängliga fält. Vanligt förekommande fält inkluderar:

  • id - Postidentifierare
  • title - Posttitel
  • done - Ny fullständighetsstatus (true/false)
  • updatedAt - Tidsstämpel för uppdateringen
  • Alla andra Todo-fält är tillgängliga

Obligatoriska Behörigheter

Åtkomstnivå Kan Växla Status
OWNER ✅ Ja
ADMIN ✅ Ja
MEMBER ✅ Ja
CLIENT ✅ Ja
COMMENT_ONLY ❌ Nej
VIEW_ONLY ❌ Nej

Notera: Anpassade roller med allowMarkRecordsAsDone: false kommer att blockeras från att använda denna mutation.

Fel Svar

TodoNotFoundError

{
  "errors": [{
    "message": "Todo was not found.",
    "extensions": {
      "code": "TODO_NOT_FOUND"
    }
  }]
}

UnauthorizedError

{
  "errors": [{
    "message": "You are not authorized.",
    "extensions": {
      "code": "UNAUTHORIZED"
    }
  }]
}

Viktiga Anteckningar

Bieffekter

Att växla en posts status utlöser flera automatiserade åtgärder:

  • Aktivitetslogg: Skapar poster för MARK_AS_COMPLETE eller MARK_AS_INCOMPLETE
  • Webhooks: Skickar meddelanden till konfigurerade webhook-slutpunkter med före/efter tillstånd
  • Automatiseringar: Utlöser TODO_MARKED_AS_COMPLETE eller TODO_MARKED_AS_INCOMPLETE automatiseringsregler
  • Realtidsnotifikationer: Skickar uppdateringar till relevanta användare (om konfigurerat)
  • Realtidspublicering: Publicerar todo-uppdateringar till anslutna klienter
  • Tidsregistrering: Uppdaterar tidslängd anpassade fält automatiskt
  • Sökindex: Uppdaterar sökindexet för förbättrad upptäckbarhet
  • Analys: Uppdaterar diagram och rapporter
  • Aktivitetsflöde: Fullständiga poster visas i företagets aktivitetsflöde

Användningstips

  • Mutationen är idempotent - att anropa den två gånger återställer posten till sitt ursprungliga tillstånd
  • Operationen är atomär - antingen lyckas den helt eller misslyckas utan några förändringar
  • Anpassade roller kan begränsa denna åtgärd via allowMarkRecordsAsDone behörigheten

Relaterade Slutpunkter

  • Lista Poster: Använd todoQueries.todos för att fråga och filtrera poster
  • Bulkuppdatering: Använd updateTodos för att modifiera flera poster på en gång

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