---
title: "Start answering machine detection on a connected leg"
method: POST
path: "/legs/{id}/amd"
tags: ["Legs"]
---

# Start answering machine detection on a connected leg

`POST /legs/{id}/amd`

## Request body

- AMDParams
  - `initial_silence_timeout` integer — Max milliseconds of silence before declaring no_speech
  - `greeting_duration` integer — Speech duration threshold (ms) above which answerer is classified as machine
  - `after_greeting_silence` integer — Silence duration (ms) after initial speech to declare human
  - `total_analysis_time` integer — Max analysis window in milliseconds. A threshold longer than this window suppresses that verdict; a window shorter than all of initial_silence_timeout, greeting_duration and after_greeting_silence is rejected, since the call could only end not_sure.
  - `minimum_word_length` integer — Minimum speech burst duration (ms) to count as a word
  - `beep_timeout` integer — Max time (ms) to wait for the voicemail beep after machine detection. 0 or omitted = disabled.

## Response `200`

AMD started

- StatusResponse
  - `instance_id` string — Instance identifier
  - `status` string, required

## Other responses

- `400` — Invalid AMD params or not a SIP leg
- `404` — Leg not found
- `409` — Leg is not in connected state

---

[API](https://skmtc.net/voiceblender/apis/voiceblender-api.md) · [All operations](https://skmtc.net/voiceblender/apis/voiceblender-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voiceblender/voiceblender-api/versions/ad30827d3b57/schema)