Skip to main content
GET
/
runs
/
{id}
/
checkpoint
Retrieve Run Checkpoint
curl --request GET \
  --url https://api.example.com/runs/{id}/checkpoint \
  --header 'Authorization: Bearer <token>'
{
  "timestamp": "2023-11-07T05:31:56Z",
  "current_node": "<string>",
  "completed_nodes": [
    "<string>"
  ],
  "node_retries": {},
  "context_values": {},
  "logs": [
    "<string>"
  ],
  "node_outcomes": {},
  "next_node_id": "<string>",
  "git_commit_sha": "<string>",
  "loop_failure_signatures": {},
  "restart_failure_signatures": {}
}

Authorizations

​
Authorization
string
header
required

JWT bearer token issued by fabro-web. See the Authentication guide for details.

Path Parameters

​
id
string
required

Unique run identifier (ULID).

Response

object | null

Checkpoint data (null if not yet available)

Serializable snapshot of execution state for crash recovery and resume.

​
timestamp
string<date-time>
required

ISO 8601 timestamp when the checkpoint was created.

​
current_node
string
required

Identifier of the node being executed at checkpoint time.

​
completed_nodes
string[]
required

Identifiers of nodes that have completed execution.

​
node_retries
object
required

Map of node identifier to retry count.

​
context_values
object
required

Key-value context map accumulated during execution.

​
logs
string[]
required

Log entries recorded during execution.

​
node_outcomes
object

Map of node identifier to outcome data for goal gate checks after resume.

​
next_node_id
string

The node to resume execution at after this checkpoint.

​
git_commit_sha
string

SHA of the git commit created at this checkpoint.

​
loop_failure_signatures
object

Failure signature counts within the main loop.

​
restart_failure_signatures
object

Failure signature counts across loop_restart edges.