---
title: "PATCH /v1/transfers/{transferId}"
method: PATCH
path: "/v1/transfers/{transferId}"
---

# PATCH /v1/transfers/{transferId}

`PATCH /v1/transfers/{transferId}`

## Request

- Base URL: `https://nhse-${ENV}-innovation-service-innovation-functions.azurewebsites.net/api`
- URL: `https://nhse-${ENV}-innovation-service-innovation-functions.azurewebsites.net/api/v1/transfers/{transferId}`
- Auth: none declared

Update an innovation transfer status

## Path parameters

- `transferId` string, uuid, required

## Request body

- object
  - `status` 'CANCELED' | 'DECLINED' | 'COMPLETED', required

## Response `204`

The innovation transfer status has been updated

- object
  - `id` string, uuid, required

## Other responses

- `400`: The innovation transfer status is invalid
- `401`: The user is not authorized to update the innovation transfer status
- `404`: The innovation transfer does not exist
- `500`: An error occurred while updating the innovation transfer status

## Changes

- **2024-11-07** `761f95f46b23`: 2 breaking, 1 info
  - added the new required request property `status`
  - for the `path` request parameter `transferId`, the format changed from no format to `uuid`
  - added the media type `application/json` for the response with the status `204`

[Operation history](https://skmtc.dev/nhs-england/apis/innovations-api-nhs-innovation-service/changes/v1/transfers/:transferId/patch.md)

---

[API](https://skmtc.dev/nhs-england/apis/innovations-api-nhs-innovation-service.md) - [All operations](https://skmtc.dev/nhs-england/apis/innovations-api-nhs-innovation-service/llms.txt) - [OpenAPI document](https://skmtc.dev/nhs-england/apis/innovations-api-nhs-innovation-service/revisions/c7535c8a7a65?raw)