---
title: "Update Transfer Destination"
method: PUT
path: "/settings/transfer-destinations/{transfer_destination_id}"
tags: ["Settings"]
---

# Update Transfer Destination

`PUT /settings/transfer-destinations/{transfer_destination_id}`

Update an existing transfer destination. Developer only.

## Path parameters

- `transfer_destination_id` string, uuid, required

## Request body

- TransferDestinationUpdateRequest — Update transfer destination request model
  - `name` string, nullable — Name of the transfer destination
  - `phone_number` string, nullable — Phone number in E.164 format (e.g., +12025551234)
  - `test_phone_number` string, nullable — Alternate number in E.164 format used for test calls when test transfer numbers are enabled
  - `description` string, nullable — Optional description of when to use this destination

## Response `200`

Successful Response

- TransferDestinationResponse — Transfer destination response model
  - `transfer_destination_id` string, uuid, required
  - `name` string, required — Name of the transfer destination
  - `phone_number` string, required — Phone number in E.164 format
  - `test_phone_number` string, nullable — Alternate number used for test calls when test transfer numbers are enabled
  - `description` string, nullable — Optional description of when to use this destination

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/b642b91e0a5c/schema)
