Skip to main content
POST

Overview

Pauses an active recurring compute goal (one created with schedule). Any pending scheduled wake is discarded and the goal stops running until resumed. The budget stays with the goal; nothing is refunded. One-off goals can’t be paused.

Authentication

A signed write proof or an access token: see Authentication schemes. Only the wallet that created the goal can pause it; other callers get a 404.

Path Parameters

string
required
Goal ID to pause

Request Body

string
Reason for pausing (logged for audit)

Response

string
The paused goal ID
string
paused
number
Runs completed so far
Only a recurring goal that is active can be paused. Otherwise the call returns not_recurring or invalid_state.