# Disable auto nurture

**POST /contacts/auto-nurture/disable**

Turn Auto Nurture off for up to 100 contacts. Each keeps its status, so a NURTURED contact stays NURTURED, and keeps auto_nurture.first_enabled_at. contacts holds the ones this call turned off; a contact already off, or not one of the agent's live contacts, is left out and nothing about it changes.

Requires the `contacts:write` scope. Rate budget: 120 calls per 1 minute per credential (the `write` class).


## Servers
- https://www.realscout.com/api/agent/v1: https://www.realscout.com/api/agent/v1 ()


## Authentication methods
- Bearer auth


## Parameters



### Body: application/json (object)
A DisableUsersAutoNurtureInput, as the agent app's own mutation takes it.
- **ids** (array[string])
  The contact ids, at most 100.



## Responses
### 200
OK
#### Headers

- **X-RateLimit-Limit** (integer)
  Calls allowed in the current window.

- **X-RateLimit-Remaining** (integer)
  Calls left in the current window.

- **X-RateLimit-Reset** (integer)
  Epoch seconds at which the window resets.


#### Body: application/json (object)
- **contacts** (array[object])


### 400
The request is invalid; `field` names the offending input when there is one. A body that is not valid JSON is refused before the API runs, as a bare 400 with no body.

#### Body: application/json (object)
- **error** (object)


### 401
Invalid or missing bearer token.

#### Body: application/json (object)
- **error** (object)


### 403
The credential was not granted the scope this call requires.

#### Body: application/json (object)
- **error** (object)


### 404
Not found, or not yours: the two are indistinguishable on purpose.

#### Body: application/json (object)
- **error** (object)


### 429
Rate limit exceeded; `Retry-After` says when to try again.
#### Headers

- **Retry-After** (integer)
  Seconds until the budget refills.


#### Body: application/json (object)
- **error** (object)


### 500
Something went wrong on our side.

#### Body: application/json (object)
- **error** (object)



[Powered by Bump.sh](https://bump.sh)
