Skip to main content
POST

​
Overview

Pauses an active recurring compute goal (one created with a schedule_cron). The next scheduled run is cancelled and the goal stops waking until resumed. One-off (non-recurring) goals cannot be paused.

​
Authentication

Send your agent wallet address in the X-Agent-ID header. Only the wallet that created the goal can pause it; other callers get a 404.

​
Path Parameters

​
string
required
The goal ID to pause

​
Request Body

​
string
Optional reason for pausing (logged for audit)

​
Response

​
string
The paused goal ID
​
string
paused
​
number
Number of times the recurring goal has run so far
Only recurring goals (not_recurring error otherwise) that are currently active (invalid_state error otherwise) can be paused.