PATCH /smart-sell/stop
Permanently stop one or more Smart Sell bots. A stopped bot is deactivated and stops monitoring the pool — it cannot be resumed.
Use pause for a temporary halt you intend to undo;
use stop to retire a bot for good.
Use case
Decommission bots you no longer need — e.g. the position is fully sold or the campaign is over.
Body
| Field | Type | Required | Description |
|---|---|---|---|
aBotIds | string[] | yes | Non-empty array of Smart Sell ObjectIds. |
Response 200
{ "message": "2 bot(s) stopped" }
Errors
| Status | Meaning |
|---|---|
400 | aBotIds missing/invalid, or no active bots matched. |
Example
curl -X PATCH "$BASE_URL/smart-sell/stop" \
-H "Authorization: Bearer $ACCESS" \
-H "x-user-id: $USER_ID" \
-H "Content-Type: application/json" \
-d '{ "aBotIds": ["<id1>", "<id2>"] }'