> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Stop Goal Now

> Pause a goal and refuse every further tool call at once

## Overview

Stop now is the kill switch. It [pauses](https://docs.oneshotagent.com/api-reference/compute/pause.md) 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](https://docs.oneshotagent.com/api-reference/compute/resume.md) lifts the stop, and the agent decides again about the calls that were refused.

It works on an `active` 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](https://docs.oneshotagent.com/api-reference/compute/cancel.md) it instead.

## Authentication

A signed **write proof** or an access token: see [Authentication schemes](https://docs.oneshotagent.com/api-reference/openapi.md#authentication-schemes).

Only the wallet that created the goal can stop it; other callers get a `404`.

## Path Parameters

**goalId** `string` *required*

Goal ID to stop

## Request Body

**reason** `string`

Why the goal was stopped (kept with the goal)

<Snippet file="audit-context-params.mdx" />

## Response

**data.goal\_id** `string`

The stopped goal ID

**data.status** `string`

`paused`

**data.stop\_now** `boolean`

`true`

**data.run\_count** `number`

Runs completed so far

**data.child\_goals\_paused** `number`

Goals this goal started that were stopped with it

```bash cURL theme={null}
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" }'
```

```json 200 theme={null}
{
  "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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.