---
title: "POST /agents/stop"
method: POST
path: "/agents/stop"
tags: ["agents"]
---

# POST /agents/stop

`POST /agents/stop`

Stops an agent.

## Headers

- `X-Phantombuster-Org` string

## Request body

- object
  - `id` string, required — Id of the agent to stop.
  - `softAbort` boolean — If true, tries to softly abort the agent.
  - `cascadeToAllSlaves` boolean — If true, slave agents will recursively be stopped (even nested slaves).
  - `dontLaunchSoon` boolean — If true, disables the next scheduled "launch soon" of the agent.
  - `switchToManualLaunch` boolean — If true, the agent will switch to manual launch.

## Response `200`

Agent stopped successfully.

## Other responses

- `400` — No agent exists with the provided id.

---

[API](https://skmtc.dev/phantombuster/apis/phantombuster-api-v2.md) · [All operations](https://skmtc.dev/phantombuster/apis/phantombuster-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/phantombuster/phantombuster-api-v2/revisions/acf0049d7c7f/schema)