# General Translation Platform: 更新项目信息
URL: https://generaltranslation.com/zh/docs/platform/openapi/reference/project/update-project.mdx
---

title: 更新项目信息
description: 通过自动化更新 General Translation 的项目级设置。更新项目信息的 API 参考。

method: POST
---

更新项目级设置，例如默认区域设置。路径中的项目 ID 必须与已认证项目一致。

## 概览 [#overview]

```http
POST https://api2.gtx.dev/v2/project/info/:projectId
```

**权限** `project:write` · **速率限制** 默认 (200/分钟) 

通过你自己的自动化流程更改项目设置。要读取当前设置，请使用[获取项目信息](/docs/platform/openapi/reference/project/project-info)。

## 工作方式 [#how-it-works]

* 路径中的 `projectId` 必须与该 API Key 所认证的项目一致。缺少该 ID 或 ID 不匹配时，会返回 `400`。
* 提供 `defaultLocale` 时，系统会对其进行验证，并将其设为项目的默认区域设置。省略该参数则会保持默认区域设置不变。
* 响应会确认请求已成功。

## 请求 [#request]

### 请求头

| 请求头               | 说明                | 必填 |
| ----------------- | ----------------- | -- |
| `x-gt-api-key`    | 项目或组织 API 密钥。     | 是  |
| `x-gt-project-id` | 项目 ID。使用组织密钥时为必填。 | 否  |

### 路径参数

| 参数          | 描述                     | 类型       | 必填 |
| ----------- | ---------------------- | -------- | -- |
| `projectId` | 项目 ID；必须与已认证项目一致。 | `string` | 是  |

### 响应体

**内容类型** `application/json`

| 字段              | 描述          | 类型       | 可选 | 默认 |
| --------------- | ----------- | -------- | -- | -- |
| `defaultLocale` | 项目的新默认区域设置。 | `string` | 是  | 不变 |

## 响应 [#response]

**状态** `200 OK`

```json title="Response"
{
  "success": true
}
```

## 错误 [#errors]

| 状态    | 原因                                                   |
| ----- | ---------------------------------------------------- |
| `400` | 缺少 `projectId`、`projectId` 不匹配，或 `defaultLocale` 无效。 |
| `401` | 缺少 API 密钥，或 API 密钥无效。                                |
| `403` | API 密钥缺少 `project:write`。                            |
| `429` | 已超出速率限制。                                             |

## 示例 [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/project/info/prj_... \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '{
    "defaultLocale": "en"
  }'
```