API Reference

Begin a side effect — checks deduplication, writes EXECUTING status. Returns CONFLICT if another agent is already executing the same operation.

{
  "executionId": "exec_abc123",
  "fingerprint": "hash_of_operation",
  "type": "STRIPE_OPERATION",
  "target": "stripe-charge",
  "inputHash": "hash_of_inputs",
  "provider": "stripe",
  "workflowId": "wf_order_123",
  "agentId": "agent_order_processor"
}

Commit a side effect — transitions EXECUTING → COMMITTED, stores result and provider-native receipt.

Mark a side effect UNKNOWN — transitions EXECUTING → UNKNOWN. Called when the SDK operation times out with no confirmed response.

Mark a side effect FAILED — transitions EXECUTING → FAILED. Called when the SDK operation throws an error (non-timeout).

Reconcile and retrieve recovery plan for a workflow. Returns a ContinuationPlan with SKIP, RETRY, and BLOCK actions.

Trigger reconciliation of all UNKNOWN side effects for a workflow. Resolves UNKNOWN effects via provider verification without computing a continuation plan.

Returns all side effects for a given agent across all executions in the project. Used for agent fleet visibility and execution memory queries.

Updates the status of the monitor associated with the API key. Triggers incident recovery if the monitor was previously down.

{
  "status": "success",
  "metadata": {
    "server": "us-east-1",
    "version": "1.0.4"
  }
}

High-fidelity endpoint for infrastructure telemetry. Used by the Sentinel CLI to report secure tunnel health, network latency, and cryptographic handshake age.

{
  "type": "TUNNEL",
  "metrics": {
    "handshakeAge": 124,  // in seconds
    "latency": 18.5,       // in milliseconds
    "peerCount": 1
  },
  "config": {
    "publicKey": "base64_string...",
    "endpoint": "vpn.example.com"
  }
}