run-memory

save checkpoint

Call after each completed step with the state you would need to continue (cursor, ids done, partial results; up to 256 KB JSON). Pro saves it (last 20 per run, kept 30 days). Free watch-only saves nothing and returns would_save: exactly what would have been stored. Never put passwords or API keys in state.

post/api/v1/run-memory/save_checkpoint

Request

  • Base URL: https://cloudforbots.com
  • URL: https://cloudforbots.com/api/v1/run-memory/save_checkpoint
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Makes the call safe to retry; the same key returns the stored reply for 24h.

X-Request-Idstring

Request body

run_idstring required

A stable id for this job that survives a crash, e.g. "invoice-import-oct". Use the same id when you restart.

stepstring required

The step you just finished, e.g. "imported page 3 of 10".

stateobject required

JSON state needed to resume.

donestring[]

Optional list of completed item ids, so a resume skips them.

Response

Tool result (always includes request_id).

object required

Changes

No recorded changes to this operation across all 1 revision of this API.