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

# POST /v1/{+name}:position

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

Changes the sort order of a 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

- `name` string, required

## Request body

- PositionSectionRequest — Request message for positioning a section.
  - `relativePosition` 'POSITION_UNSPECIFIED' | 'START' | 'END' — Optional. The relative position of the section in the list of sections.
  - `sortOrder` integer — Optional. The absolute position of the section in the list of sections. The position must be greater than 0. If the position is greater than the number of sections, the section will be appended to the end of the list. This operation inserts the section at the given position and shifts the original section at that position, and those below it, to the next position.

## Response `200`

Successful response

---

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