# Turn an agent's goal off

Source: https://docs.vlayers.ai/reference/agents/clear-agent-goal

`DELETE /v1/agents/{id}/goal` · scope `workspace:write`

Stops scoring for the agent. Verdicts already given are kept, so the rates you have read do not move. Setting a goal again starts scoring again.

Requires an API key with the `workspace:write` scope.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The agent id. Example: `"0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78"` |

## Request

cURL:

```bash
curl -X DELETE "https://api.vlayers.ai/v1/agents/$AGENT_ID/goal" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

await voicelayer.agents.clearGoal('<agent-id>');
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

vl.agents.clear_goal("<agent-id>")
```

## Response `200`

```json
{
  "cleared": true
}
```
