---
title: "POST /v1/operations/policies.update"
method: POST
path: "/v1/operations/policies.update"
---

# POST /v1/operations/policies.update

`POST /v1/operations/policies.update`

## Request

- Base URL: `https://sagots.com` (the document declares no server; this is the origin it was published from)
- URL: `https://sagots.com/v1/operations/policies.update`
- Auth: HTTP bearer

## Request body

- object
  - `workspaceId` string, uuid, required
  - `revision` integer, required
  - `policy` object, required
    - `timezone` string, required
    - `startHour` integer, required
    - `endHour` integer, required
    - `weekdays` integer[], required
    - `maxAttempts` integer, required
    - `maxSeconds` integer, required
    - `budgetCentavos` integer, required
    - `paused` boolean, required
    - `disclosure` string, required: Spoken once after the person agrees to continue, before the main conversation. Not part of the greeting.
    - `retentionDays` integer, required
    - `recordAudio` boolean, required: Keep an audio recording of each call (phase 40-05). Off: no audio is stored; transcripts are still kept for retentionDays. The disclosure must still say the call is recorded or transcribed.
    - `autoRetry` boolean, required: Automatically call again after an unanswered or failed attempt, up to maxAttempts per contact.
    - `retryDelayMinutes` integer, required: Wait before the first automatic retry; each further retry waits twice as long.
    - `assistantCallApproval` boolean, required: Calls that a connected AI assistant (OAuth, phase 41) asks for wait until a person approves them on the website. Admins can turn this off; assistants never can.
    - `monthlySpendLimitCentavos` integer, nullable, required: Optional cap on what calls on SAGOT numbers may cost per calendar month (UTC), in centavos (phase 42). null (default) = no cap: the prepaid balance is the limit. When set, a call whose maximum cost would pass it is refused.

## Response `200`

Operation result

## Other responses

- `400`: Structured error

---

[API](https://skmtc.dev/sagots/apis/sagot-operations.md) · [All operations](https://skmtc.dev/sagots/apis/sagot-operations/llms.txt) · [OpenAPI document](https://skmtc.dev/sagots/apis/sagot-operations/revisions/da45e0cbcbde?raw)