---
title: "Update Agent Audit Sampling"
method: PUT
path: "/settings/agent-audit-sampling"
tags: ["settings"]
---

# Update Agent Audit Sampling

`PUT /settings/agent-audit-sampling`

## Request

- Base URL: `https://api.verdun.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.verdun.ai/settings/agent-audit-sampling`
- Auth: HTTP bearer

Field-specific write, same reasoning as update_slow_triage_target.
Applies to the next audit-queue read; calls already audited keep their
audits, and calls that leave the sample simply stop showing as Needs audit.

## Request body

- UpdateAgentAuditSamplingRequest: Body for PUT /settings/agent-audit-sampling. Both fields REQUIRED but nullable: null reverts that disposition to the server default, and an omitted field is a 422 rather than an accidental reset.
  - `false_alarm_bp` integer, nullable, required: Share of the agent's False alarm closes put up for audit, in basis points (100 = 1%, 0 = none). Null reverts to the server default.
  - `non_threatening_bp` integer, nullable, required: Share of the agent's Non-threatening human activity closes put up for audit, in basis points (10 = 0.1%). Null reverts to the server default.

## Response `200`

Successful Response

- GetAgentAuditSamplingResponse
  - `false_alarm` AgentAuditSamplingRate, required
    - `configured_bp` integer, nullable: Rate set in the console, in basis points; null when not set.
    - `default_bp` integer, required: What applies when configured_bp is null.
    - `effective_bp` integer, required: The rate selection uses right now (100 = 1%).
    - `closes_last_7_days` integer, required: The agent's closes with this disposition in the last 7 days.
    - `expected_per_week` integer, required: closes_last_7_days x effective rate, rounded: about how many reach the audit queue a week.
  - `non_threatening` AgentAuditSamplingRate, required
    - `configured_bp` integer, nullable: Rate set in the console, in basis points; null when not set.
    - `default_bp` integer, required: What applies when configured_bp is null.
    - `effective_bp` integer, required: The rate selection uses right now (100 = 1%).
    - `closes_last_7_days` integer, required: The agent's closes with this disposition in the last 7 days.
    - `expected_per_week` integer, required: closes_last_7_days x effective rate, rounded: about how many reach the audit queue a week.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verdun/apis/verdun-api.md) - [All operations](https://skmtc.dev/verdun/apis/verdun-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verdun/apis/verdun-api/revisions/35a2a6ebedda?raw)
