> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Update monitoring

> Change a workspace's monitoring schedule and selected models, pause monitoring, or validate a change with dryRun before saving it with the ETag.

Updates the supplied monitoring settings. Read [Get monitoring](https://docs.qwairy.co/developers/endpoints/brands/monitoring.md)
first and copy its ETag. When the GET returns computed defaults, the initial
ETag is `"0"`; this PATCH persists the first settings. Fields you omit keep
the defaults: no model and no automatic answers.

Requires an active Business, Agency Business or Enterprise plan. Use an API token with write access enabled. See [Writing data](https://docs.qwairy.co/developers/writing-data.md) for
idempotency, conditional requests and error handling.

**Authorization** `string` *required*

Bearer token for your team.

**If-Match** `string` *required*

Copy the complete `ETag` from the latest GET, including its quotes.

**brandId** `string` *required*

Workspace identifier. The workspace must belong to the token's team.

**frequency** `string`

`NONE`, `DAILY`, `WEEKLY` or `MONTHLY`. `NONE` stops the workspace
schedule: prompts that inherit it stop, while prompts with their own
frequency keep running, as in the dashboard.

**analysisWeekDay** `integer | null`

Day from 1 to 7 for weekly monitoring. On the first persisted settings,
omitted or null uses the current weekday; later updates can store null.

**analysisMonthDay** `integer | null`

Day from 1 to 28 for monthly monitoring. On the first persisted settings,
omitted or null uses day 1; later updates can store null.

**autoGenerateAnswers** `boolean`

Whether scheduled analysis automatically generates answers.

**models** `string[]`

Replacement list of 1 to 20 enabled Qwairy model codes. Read the currently
selected codes with GET. Unknown or disabled codes are rejected.

**dryRun** `boolean` (default: false)

Validate the change and return the result without changing anything.

Supply at least one editable field. Setting `NONE` preserves per-prompt
monitoring settings. Work accepted before the change may still finish.

## Response

Returns `200`, a new `ETag` and a `monitoring` object with the same fields
as [Get monitoring](https://docs.qwairy.co/developers/endpoints/brands/monitoring.md).
`paused` reflects whether `frequency` is `NONE`; `isDefault` is false
once settings are persisted.

## Synthetic request and response

This example assumes the current monitoring ETag is `"3"`.

```bash theme={null}
curl -X PATCH "https://www.qwairy.co/api/v1/brands/$BRAND_ID/monitoring" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H 'If-Match: "3"' \
  -H "Content-Type: application/json" \
  -d '{"frequency":"NONE"}'
```

```json theme={null}
{
  "monitoring": {
    "brandId": "b1c2d3e4-0000-4000-8000-000000000000",
    "frequency": "NONE",
    "paused": true,
    "analysisWeekDay": 1,
    "analysisMonthDay": 1,
    "autoGenerateAnswers": true,
    "models": ["openai-gpt"],
    "lastAnalysisDate": null,
    "version": 4,
    "isDefault": false
  }
}
```

## Errors

| Status | Code | Cause |
| - | - | - |
| 400 | `INVALID_REQUEST` | Invalid schedule or empty/unavailable model selection |
| 403 | `INSUFFICIENT_PLAN` | A selected model is a premium model your plan does not include |
| 404 | `RESOURCE_NOT_FOUND` | Workspace is missing or inaccessible |
| 412 | `PRECONDITION_FAILED` | Monitoring changed since your read |
| 428 | `PRECONDITION_REQUIRED` | `If-Match` is missing |

See [Error codes](https://docs.qwairy.co/developers/errors.md) for authentication, plan, idempotency
and server errors. On `429`, honor `Retry-After`; writes can return
`503 SERVICE_UNAVAILABLE` if the write limiter is unavailable.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.