---
title: "POST /v1/{+name}:move"
method: POST
path: "/v1/{+name}:move"
tags: ["projects"]
---

# POST /v1/{+name}:move

`POST /v1/{+name}:move`

Moves an assignment under a new reservation. This differs from removing an existing assignment and recreating a new one by providing a transactional change that ensures an assignee always has an associated reservation.

## Path parameters

- `name` string, required

## Request body

- MoveAssignmentRequest — The request for ReservationService.MoveAssignment. **Note**: "bigquery.reservationAssignments.create" permission is required on the destination_id. **Note**: "bigquery.reservationAssignments.create" and "bigquery.reservationAssignments.delete" permission are required on the related assignee.
  - `assignmentId` string — The optional assignment ID. A new assignment name is generated if this field is empty. This field can contain only lowercase alphanumeric characters or dashes. Max length is 64 characters.
  - `destinationId` string — The new reservation ID, e.g.: `projects/myotherproject/locations/US/reservations/team2-prod`

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/bigqueryreservation.md) · [All operations](https://skmtc.dev/google/apis/bigqueryreservation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/bigqueryreservation/revisions/3502c38ecee3/schema)