Skip to main content
PATCH
Update monitoring
Updates the supplied monitoring settings. Read Get monitoring 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 for idempotency, conditional requests and error handling.
string
required
Bearer token for your team.
string
required
Copy the complete ETag from the latest GET, including its quotes.
string
required
Workspace identifier. The workspace must belong to the token’s team.
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.
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.
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.
boolean
Whether scheduled analysis automatically generates answers.
string[]
Replacement list of 1 to 20 enabled Qwairy model codes. Read the currently selected codes with GET. Unknown or disabled codes are rejected.
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. 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".

Errors

See Error codes for authentication, plan, idempotency and server errors. On 429, honor Retry-After; writes can return 503 SERVICE_UNAVAILABLE if the write limiter is unavailable.