---
title: "POST /v1/users/{usersId}/sections/{sectionsId}/items/{itemsId}:move"
method: POST
path: "/v1/users/{usersId}/sections/{sectionsId}/items/{itemsId}:move"
tags: ["users"]
---

# POST /v1/users/{usersId}/sections/{sectionsId}/items/{itemsId}:move

`POST /v1/users/{usersId}/sections/{sectionsId}/items/{itemsId}:move`

## Request

- Base URL: `https://chat.googleapis.com`
- URL: `https://chat.googleapis.com/v1/users/{usersId}/sections/{sectionsId}/items/{itemsId}:move`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/chat.users.sections`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/chat.users.sections`

Moves an item from one section to another. For example, if a section contains spaces, this method can be used to move a space to a different section. For details, see [Create and organize sections in Google Chat](https://support.google.com/chat/answer/16059854). Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with the [authorization scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.users.sections`

## Path parameters

- `usersId` string, required
- `sectionsId` string, required
- `itemsId` string, required

## Request body

- MoveSectionItemRequest: Request message for moving a section item across sections.
  - `targetSection` string: Required. The resource name of the section to move the section item to. Format: `users/{user}/sections/{section}`

## Response `200`

Successful response

- MoveSectionItemResponse: Response message for moving a section item.
  - `sectionItem` SectionItem: A user's defined section item. This is used to represent section items, such as spaces, grouped under a section.
    - `name` string: Identifier. The resource name of the section item. Format: `users/{user}/sections/{section}/items/{item}`
    - `space` string: Optional. The space resource name. Format: `spaces/{space}`

---

[API](https://skmtc.dev/google/apis/chat.md) - [All operations](https://skmtc.dev/google/apis/chat/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/chat/revisions/ffee5784d4b1?raw)