---
title: "Update part transfer request"
method: PATCH
path: "/parttransferrequests/{id}"
tags: ["Part Transfer Requests"]
---

# Update part transfer request

`PATCH /parttransferrequests/{id}`

## Path parameters

- `id` integer, required

## Query parameters

- `skipWebhook` boolean

## Request body

- object
  - `status` 'APPROVED' | 'CANCELED' | 'COMPLETED' | 'DECLINED' | 'PENDING', required — Status of the part transfer request.
  - `responseMessage` string, nullable — Message to give context surrounding the transfer of the part transfer request.
  - `sourceLocationId` integer — ID of the location in the organization from which parts were transferred. (Sending stocks)
  - `destinationLocations` object[] — Locations into which the transferred parts were received. (Receiving stocks)
    - `locationId` integer — ID of the location in the organization where the part is being received. (Receiving stocks)
    - `quantity` integer, required — Quantity of parts received.
  - `quantity` integer, nullable — Quantity to update for the relevant status.

## Response `200`

Successfully updated part transfer request

- object
  - `partTransferRequest` object, required
    - `id` integer, required — Global ID of the part transfer request.
    - `quantityReceived` integer, nullable — Quantity of parts received.
    - `quantityRequested` integer, required — Quantity of parts requested for transfer.
    - `quantityTransferred` integer, nullable — Quantity of parts transferred.
    - `requestMessage` string, nullable — Message to give context surrounding the part transfer request.
    - `responseMessage` string, nullable — Message to give context surrounding the transfer of the part transfer request.
    - `status` 'APPROVED' | 'CANCELED' | 'COMPLETED' | 'DECLINED' | 'PENDING' — Status of the part transfer request.
    - `sourcePartId` integer, required — ID of the part that belongs to the organization receiving the request. (Sending stocks)
    - `destinationPartId` integer, required — ID of the part that belongs to the organization performing the request. (Receiving stocks)
    - `transferrerId` integer, nullable — ID of the user performing the transfer. (Sending stocks)
    - `requesterId` integer — ID of the user performing the request. (Requesting/receiving stocks)
    - `destinationOrganizationId` integer, required — ID of the organization performing the request. (Requesting/receiving stocks)
    - `sourceOrganizationId` integer, required — ID of the organization receiving the request. (Sending stocks)
    - `sourceLocationId` integer — ID of the location in the organization from which parts were transferred. (Sending stocks)
    - `destinationLocations` object[] — Locations into which the transferred parts were received. (Receiving stocks)
      - `locationId` integer — ID of the location in the organization where the part is being received. (Receiving stocks)
      - `quantity` integer, required — Quantity of parts received.

## Other responses

- `400` — Failed to edit the part transfer request
- `401` — Invalid token
- `404` — Could not find the specified partTransferRequest.

---

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