# chiefOfStaff.general.update

Change the Chief of Staff's settings that apply everywhere: pause it, turn direct messages on or off, turn tools off everywhere, or replace the list of people it never replies to. Takes effect on its next message. Pass expectedRevision from chiefOfStaff.settings.get. Only the platform owner's workspace has a Chief of Staff. Administrator access required.

`POST /api/v1/accounting/chiefOfStaff.general.update`

Permissions: `accounting:read`, `accounting:write`, `accounting:admin` · Roles: admin · Idempotency key required · Send `expectedRevision`

MCP tool: `accounting_chief_of_staff_general_update`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `paused` | boolean |  | Stop every reply and scheduled post until turned back on. Slash commands still answer. |
| `directMessages` | enum |  | One of: `on`, `off`. |
| `disabledTools` | array of enum values |  | Tools turned off everywhere, whatever else allows them. One of: `getCurrentEventsFromLuma`, `getEventStatsFromLuma`, `getEventDetailsFromLuma`, `getEventGuestsFromLuma`, `getCommunityContacts`, `webSearch`, `scrapeUrl`, `github`, `weather`. at most 9 items. |
| `ignoredPeople` | array of objects |  | People the Chief of Staff never replies to. Replaces the list. at most 200 items. |
| `ignoredPeople[].userId` | string | Yes | The ID of a person in your company. Matches ^\d{17,20}$. |
| `ignoredPeople[].name` | string or null |  | A display name. |
| `expectedRevision` | integer |  | The revision you last read: 0 for something never saved. A different revision means someone else changed it first. 0 to 9007199254740990. |
| `idempotencyKey` | string | Yes | Any unique text you generate once per intended change, so a retried request only happens once. Send it as the Idempotency-Key header instead if you prefer; if you send both they must match. 8–200 characters. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/chiefOfStaff.general.update \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'
```

Reference page: https://app.getoatmilk.com/docs/api/chiefOfStaff.general.update