---
title: "Set AMD config"
method: POST
path: "/v1/amd/config"
tags: ["AMD"]
---

# Set AMD config

`POST /v1/amd/config`

## Request

- Base URL: `https://api.pyai.com`
- URL: `https://api.pyai.com/v1/amd/config`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Set the account-default operating point and webhook. `aggressiveness` is one dial on the ROC curve: near **0** is human-safe (never hang up on a person, for live-agent dialers; on the deadline it returns `unknown` rather than risk a false `machine`), near **1** fires `machine` fast (for AI voicemail-drop bots). A per-call TwiML `<Parameter name="aggressiveness">` overrides this. Requires `amd:configure`.

## Request body

- AmdConfigInput
  - `aggressiveness` number
  - `webhook_url` string, uri, nullable

## Response `200`

Updated AMD config

- AmdConfig
  - `object` string
  - `aggressiveness` number: Operating point on the ROC curve. Near 0 = human-safe (never hang up on a person); near 1 = fire `machine` fast. Per-call TwiML `<Parameter>` overrides this.
  - `webhook_url` string, uri, nullable
  - `updated_at` integer: Unix ms.

## Other responses

- `400`: Invalid request (bad field, unsupported value)
- `401`: Missing or invalid API key (`code: unauthorized`)

---

[API](https://skmtc.dev/pyai/apis/pyai-api.md) · [All operations](https://skmtc.dev/pyai/apis/pyai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pyai/apis/pyai-api/revisions/819d8e7c4d09?raw)