---
title: "Decline a parked inbound REFER"
method: POST
path: "/legs/{id}/transfer/decline"
tags: ["Legs"]
---

# Decline a parked inbound REFER

`POST /legs/{id}/transfer/decline`

Rejects a parked (not-yet-accepted) inbound transfer, replying to the referrer with a non-2xx (`603 Decline` by default; override via `code`/`reason`) and emitting `leg.transfer_failed`.

## Request body

- TransferDeclineRequest
  - `code` integer
  - `reason` string

## Response `202`

Decline queued

## Other responses

- `404` — No pending transfer for the leg (unknown or already accepted)

## Changes

- **2026-07-10** `849665fa5507` — 1 info
  - endpoint added
- **2026-03-26** `d09c97c6ca8c` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/voiceblender/apis/voiceblender-api/changes/legs/:id/transfer/decline/post.md)

---

[API](https://skmtc.dev/voiceblender/apis/voiceblender-api.md) · [All operations](https://skmtc.dev/voiceblender/apis/voiceblender-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/voiceblender/voiceblender-api/revisions/89ff267f0958/schema)