---
title: "Reassign a terminal"
method: POST
path: "/terminals/{terminalId}/reassign"
tags: ["Terminals - terminal level"]
---

# Reassign a terminal

`POST /terminals/{terminalId}/reassign`

## Request

- Base URL: `https://management-test.adyen.com/v3`
- URL: `https://management-test.adyen.com/v3/terminals/{terminalId}/reassign`
- Auth: one of:
  - HTTP basic
  - API key in header `X-API-Key`

Reassigns a payment terminal to a company account, merchant account, merchant account inventory, or a store.

To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):
* Management API—Assign Terminal

In the live environment, requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment).

## Path parameters

- `terminalId` string, required

## Request body

- TerminalReassignmentRequest
  - `companyId` string: The unique identifier of the company account to which the terminal is reassigned.
  - `inventory` boolean: Must be specified when reassigning terminals to a merchant account: - If set to **true**, reassigns terminals to the inventory of the merchant account and the terminals cannot process transactions. - If set to **false**, reassigns terminals directly to the merchant account and the terminals can process transactions.
  - `merchantId` string: The unique identifier of the merchant account to which the terminal is reassigned. When reassigning terminals to a merchant account, you must specify the `inventory` field.
  - `storeId` string: The unique identifier of the store to which the terminal is reassigned.

## Response `200`

No Content - look at the actual response code for the status of the request.

## Other responses

- `400`: Bad Request - a problem reading or understanding the request.
- `401`: Unauthorized - authentication required.
- `403`: Forbidden - insufficient permissions to process the request.
- `422`: Unprocessable Entity - a request validation error.
- `500`: Internal Server Error - the server could not process the request.

---

[API](https://skmtc.dev/adyen/apis/management-api.md) - [All operations](https://skmtc.dev/adyen/apis/management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adyen/apis/management-api/revisions/55cb8143ce0e?raw)