diff --git a/docs/en/concepts/checkpointing.mdx b/docs/en/concepts/checkpointing.mdx
index 8f841a466..1cc21b5b2 100644
--- a/docs/en/concepts/checkpointing.mdx
+++ b/docs/en/concepts/checkpointing.mdx
@@ -44,7 +44,7 @@ Two providers ship with CrewAI:
 Both prune oldest checkpoints when `max_checkpoints` is set.
 
 <Note>
-Checkpoint writes are best-effort. A failed checkpoint is logged but does not interrupt the run.
+Auto-checkpoint writes (event-driven) are best-effort: a failed write is logged and the run continues. Manual `state.checkpoint()` and `state.acheckpoint()` calls re-raise on failure.
 </Note>
 
 ### Inheritance model
diff --git a/docs/pt-BR/concepts/checkpointing.mdx b/docs/pt-BR/concepts/checkpointing.mdx
index b5cdfe199..2ec738168 100644
--- a/docs/pt-BR/concepts/checkpointing.mdx
+++ b/docs/pt-BR/concepts/checkpointing.mdx
@@ -44,7 +44,7 @@ Dois provedores acompanham o CrewAI:
 Ambos removem os checkpoints mais antigos quando `max_checkpoints` está definido.
 
 <Note>
-As gravações de checkpoint são best-effort. Um checkpoint que falha é registrado em log, mas não interrompe a execução.
+Gravações de checkpoint automáticas (acionadas por evento) são best-effort: uma falha é registrada em log e a execução continua. Chamadas manuais a `state.checkpoint()` e `state.acheckpoint()` relançam a exceção.
 </Note>
 
 ### Modelo de herança