curl -X POST https://win.oneshotagent.com/v1/compute/3f2b9c1e-8d4a-4f6b-9e2a-7c1d5b8a0f42/stop \
-H "Content-Type: application/json" \
-H "X-Agent-ID: 0xYourWalletAddress" \
-H "x-agent-proof: <base64 EIP-712 proof, scope write>" \
-d '{ "reason": "Wrong contact list" }'
{
"success": true,
"data": {
"goal_id": "3f2b9c1e-8d4a-4f6b-9e2a-7c1d5b8a0f42",
"status": "paused",
"stop_now": true,
"run_count": 0,
"child_goals_paused": 0
}
}
Budget and control
Stop Goal Now
Pause a goal and refuse every further tool call at once
POST
/
v1
/
compute
/
{goalId}
/
stop
curl -X POST https://win.oneshotagent.com/v1/compute/3f2b9c1e-8d4a-4f6b-9e2a-7c1d5b8a0f42/stop \
-H "Content-Type: application/json" \
-H "X-Agent-ID: 0xYourWalletAddress" \
-H "x-agent-proof: <base64 EIP-712 proof, scope write>" \
-d '{ "reason": "Wrong contact list" }'
{
"success": true,
"data": {
"goal_id": "3f2b9c1e-8d4a-4f6b-9e2a-7c1d5b8a0f42",
"status": "paused",
"stop_now": true,
"run_count": 0,
"child_goals_paused": 0
}
}
Overview
Stop now is the kill switch. It pauses the goal and refuses every tool call it makes from this moment, including calls a step in progress had not yet sent. A call that has already been sent finishes. Nothing is refunded and nothing is lost: resume lifts the stop, and the agent decides again about the calls that were refused. It works on anactive goal and on one that is already paused. Goals this goal started are stopped with it. To end the goal for good and get the unspent budget back, cancel it instead.
Authentication
A signed write proof or an access token: see Authentication schemes. Only the wallet that created the goal can stop it; other callers get a404.
Path Parameters
Request Body
Response
curl -X POST https://win.oneshotagent.com/v1/compute/3f2b9c1e-8d4a-4f6b-9e2a-7c1d5b8a0f42/stop \
-H "Content-Type: application/json" \
-H "X-Agent-ID: 0xYourWalletAddress" \
-H "x-agent-proof: <base64 EIP-712 proof, scope write>" \
-d '{ "reason": "Wrong contact list" }'
{
"success": true,
"data": {
"goal_id": "3f2b9c1e-8d4a-4f6b-9e2a-7c1d5b8a0f42",
"status": "paused",
"stop_now": true,
"run_count": 0,
"child_goals_paused": 0
}
}
Errors
| Code | Status | When |
|---|---|---|
invalid_state | 400 | The goal is not active or paused |
not_pausable | 400 | The goal runs on the older planner; cancel it instead |