# General Translation Platform: 调整上下文分组顺序
URL: https://generaltranslation.com/zh/docs/platform/openapi/reference/context-groups/reorder-context-group.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 将已分配的组移动到新位置（索引从零开始）。需要 org:context:write 权限。

{/* 此文件由 Fumadocs 生成。请勿直接编辑此文件。如需更改，请重新运行生成命令。 */}

## Endpoint

`PATCH https://api.gtx.dev/v2/projects/{projectId}/context-groups/{groupId}`

**Operation ID:** `reorderContextGroup`

**Tags:** `Context groups`

**Summary:** Reorder a context group

Moves the assigned group to a new zero-based position. Requires `org:context:write`.

Authentication: required. Send an API key in the `Authorization: Bearer <key>` header when authenticating.

### Parameters

- `projectId` (path, string, required): Project ID.
- `groupId` (path, string, required): Context group ID.
- `gt-api-version` (header, "2026-10-08.v1", optional): API contract version. Defaults to the oldest supported version.

### Request body (required)

Body (`application/json`, object):
- `targetIndex` (integer, required): Zero-based position; out-of-range values move the group to the first or last position.

### Responses

**200**: Assignments reordered
Response body (`application/json`, object):
- `committed` (true, required)

**400**: The request is malformed or failed validation.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**401**: Authentication is missing or invalid.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**403**: The caller is authenticated but not allowed to perform this operation or access the requested resource.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**404**: The requested resource was not found.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**413**: The request, or the data it would return, exceeds a size or item limit.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**415**: The request body's Content-Type is missing or not supported. Send the body as application/json.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**429**: Too many requests. The rate limit was exceeded.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**500**: An unexpected server error occurred.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

Complete OpenAPI 3.1 specification: https://generaltranslation.com/openapi.yaml

OpenAPI schema: [openapi.json](https://generaltranslation.com/openapi.json)

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.