> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 预算

> 了解企业预算如何构成 ACU 限额树，如何设置月度周期和各预算的用户层级，以及如何通过 API 管理预算。

借助预算，你可以按照公司的组织架构为 ACU 用量设置上限：为整个账户设置一个总限额，为各团队或项目设置共享额度池，并在每个额度池内设置单用户限额。

## 用例示例

### 由部门管理员分级管理

Acme Corp 有 10 个部门。各部门负责人管理本部门下属组织的限额，中央 IT 部门负责设定每个部门的总额。本示例展示其中两个部门。

企业管理员 Alice 在 Account 预算下为每个部门分别创建一个预算，并将其共享给对应的部门管理员。各部门管理员再为本部门下属的每个组织创建预算。

![Account 预算为 100,000 ACU，其中 Engineering 为 30,000 ACU，下设 Payments 和 Search；Marketing 为 5,000 ACU。](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/budget-departments.svg?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=fd65b7ebd17f98f03e694dae32493b69)

Account 预算下的部门预算

* Engineering 部门管理员 Bob 可以为 Engineering 下的任意预算设置限额和临时限额。例如，在业务繁忙的一周，他可以为 Payments 设置 6,000 ACU 的临时限额。
* Bob 无法提高 Engineering 的 30,000 ACU 限额，只有 Alice 有权调整。
* Engineering 下所有组织的用量都会计入这 30,000 ACU 限额，即使各组织预算之和超出该值也不例外。

![部门管理员视角下的 预算 页面](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/dept-admin-tree.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=9f921d3d02cf54e6a28792beb1db26b5)

部门管理员视角下的 Budgets 页面，Account 预算处于锁定状态

![提高子预算限额](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/dept-admin-edit-child.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=a12442bc7a00464d08283bad62358864)

部门管理员提高子预算限额

![部门预算限额为只读](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/dept-admin-own-limit.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=7fc6e5bf029581de28e3290e6beb7554)

部门管理员无法更改部门预算限额

### 为项目单独划拨额度并提高用户限额

每位开发者每月有 200 ACU。针对迁移项目，Acme Corp 额外划拨 5,000 ACU，并允许项目成员使用更多额度。

将 Developer tools 组织保留在 Developer tools 预算中，并为该预算设置 200 ACU 的默认层级。创建一个限额为 5,000 ACU 的 Migration initiative 预算，将该项目的组织放入其中，并为其设置 1,000 ACU 的默认层级。这两个预算都位于 Account 预算之下。

![Developer tools 预算为 20,000 ACU，默认层级为 200 ACU；Migration initiative 预算为 5,000 ACU，默认层级为 1,000 ACU。](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/budget-project.svg?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=a0d7477384a985d998a72ef8ae73f481)

Developer tools 和 Migration initiative 预算及其层级

* 项目开发者 Carol 在 Migration 组织中最多可使用 1,000 ACU，在 Developer tools 组织中最多可使用 200 ACU。
* 整个项目每月的用量始终不会超过 5,000 ACU。

![“我的分析”预算选择器](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/my-analytics-multi-budget.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=1b91652d38ed08edbcba1468f074af59)

包含多个预算的“我的分析”预算选择器

## 预算的工作原理

### 预算树

每个企业账户有一棵预算树。树的根节点是 **Account 预算** (账户预算) ，子预算位于其下。一棵树最多可有三个层级。

一个预算可以包含一个或多个组织。每个组织只能属于一个预算。新组织默认归入 Account 预算。

例如，Acme Corp 为其 Account 预算 设置了 100,000 ACU 的限额，Engineering 又将自己的资源池拆分为三个子预算。

![100,000 ACU 的 Account budget，其下包括 40,000 ACU 的 Engineering 及其三个子预算，以及 20,000 ACU 的 Developer tools 及其三个用户限额层级。](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/budget-tree.svg?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=48dc89ce8cd22e3043b576e5349ce1e0)

包含预算和用户限额层级的预算树

层级是同一预算内的单用户限额，并非独立的预算。

![显示各预算使用率的预算树](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/tree.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=cc09209e5169718deadade894b7b4802)

显示各预算使用率的预算树（模拟数据）

### 预算限额

预算限额用于在一个月度周期内，为该预算下的组织及其子预算中的组织设定 ACU 总用量上限。限额为 `null` 表示不设上限。

* **用量会计入每一级上级预算。** 子预算中的用量同时计入其父预算和 Account 预算。
* **上级预算耗尽时会阻止其所有子预算。** 路径上任一预算用尽后，该分支将无法继续产生用量。
* **子预算限额之和可以超过父预算限额。** 但它们的总用量仍受父预算限额约束。
* **未设置限额的预算仍受其上级预算的限制。**

仅关联一个组织的预算与该组织共享同一限额。已弃用的[组织级 ACU 限额端点](https://docs.devin.ai/zh/admin/billing/org-acu-limits#organization-endpoints)同样可以设置该限额，你也可以使用下方的[更新端点](#update-a-budget)。

### 预算耗尽后会怎样

预算耗尽后，其下属组织将暂停使用；任一父级预算耗尽时，同样会暂停使用。使用将在下一个月度周期恢复，或在管理员提高额度、设置临时限额后恢复。

* **Devin 会话：** 无法启动新会话，正在运行的会话将进入休眠。用户会看到“请提高您组织的用量上限。”
* **Devin CLI 和 Desktop 本地智能体：** 请求将被阻止。用户会看到“您的组织已达到每月用量上限。请联系账户管理员提高上限，或等待下月上限重置。”
* **Devin Review：** 无法发起新的审查。

![消息编辑器横幅：已达到用量上限](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/cloud-limit-reached.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=419babb34f9e136d7cd10853b3d18074)

预算用尽时的消息编辑器横幅

### 月度周期

预算限额、用户限额和临时限额会在每个月度周期开始时重置。每个周期从您的计费阶段起始日开始，不一定与自然月一致。

例如，如果计费阶段从 15 日开始，则周期依次为 10 月 15 日至 11 月 14 日、11 月 15 日至 12 月 14 日，以此类推。

**临时限额**会在当前周期的剩余时间内替代预算限额，永久限额将在下一个周期恢复生效。临时用户覆盖会在当前周期结束时失效。

![设置了临时限额的 Marketing 预算](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/limits-temporary.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=f5394365ee93dd0a9107ec8d650e8a93)

临时限额将 Marketing 的额度提高到 6,000 ACU，仅在本周期内有效

### 预算中的用户限额

用户限额用于限制单个用户在一个月度周期内的用量。每个已关联组织的预算都有各自的用户限额，且仅在该预算内生效。

* **层级。** 每个预算都有各自的层级和一个默认层级。层级决定其成员每月的 ACU 限额。
* **IdP 组映射。** 将身份提供商中的组映射到某个层级，该组的成员即归入该层级。
* **覆盖。** 为单个用户设置永久或临时限额。
* **申请策略。** 每个层级可设置提高限额请求的处理方式。`unconditional` 和 `conditional` 会自动批准不超过该层级 `max_limit` 的申请；`manual` 则将申请转交管理员审查。
* **作用域。** 用户限额仅统计该用户在该预算所属各组织中的用量。
* **复制与清除。** 可从其他预算或账户复制层级，也可一并复制 IdP 组映射、分配和覆盖。如需从头配置，可清除预算中的所有层级。

> [!WARNING]
>
> 父预算上设置的用户限额不适用于其子预算。例如，如果 Engineering 本身也包含一个组织，那么在 Engineering 上设置的 300 ACU 用户限额不会限制用户在 Payments 或 Search 中的用量。

![“复制用量策略”对话框](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/copy-policies.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=bafda52c62081f5c5d3d71266eff8cad)

以 Developer tools 作为来源的“复制用量策略”对话框

### 谁可以管理预算

企业管理员在**企业设置**的**预算**中管理预算，可管理整个预算树，包括 Account 预算。

* **委派。** 企业管理员可以在 Manage access 选项卡中将预算共享给某个人或组。被委派的管理员可以在该预算下创建子预算，并为这些子预算设置限额和临时限额。委派功能需单独启用，请联系您的账户团队。
* **被委派的管理员无法提高所共享预算本身的限额。** 只有管理父预算的管理员才能更改该限额。
* **成员**可以在**我的分析**中查看自己的用量和限额。

![Engineering 预算的 Manage access 选项卡](https://mintcdn.com/cognitionai/_lCZXv8Jkk2Nq1kL/images/admin/budgets/dept-admin-access.png?fit=max\&auto=format\&n=_lCZXv8Jkk2Nq1kL\&q=85\&s=a90c02116678e594ff6dfef6511b6724)

Engineering 预算的 Manage access 选项卡，Bob 为管理者

## 常见问题

> [accordion] 组织管理员能否设置组织的 ACU 限额？
>
> 不能。组织的 ACU 限额由企业管理员设置。如需让团队自行管理其限额，可将一个预算共享给该团队的管理员。

> [accordion] 为什么组织限额端点返回 409？
>
> 为您的企业强制执行预算限额后，如果某个组织与其他组织共享预算，或直接位于 Account 预算之下，组织限额端点将返回 HTTP `409`，错误信息为“This organization has no limit of its own. Set the limit on its budget.”。例如，如果 Globex、Initech 和 Umbrella 共享同一个预算，则为 Globex 写入限额时将返回 `409`。

> [accordion] 限额何时重置？
>
> 在每个月度周期开始时重置。月度周期从您计费阶段的起始日开始计算。

> [accordion] 一个组织能否同时属于两个预算？
>
> 不能。每个组织只能属于一个预算，而一个预算可以包含多个组织。

## 使用 V3 API 管理预算

所有请求均使用企业**服务用户令牌**进行身份验证。调用方需要拥有 **ManageAcuLimits** 账户权限，或拥有该预算的[委派访问权限](#who-can-manage-a-budget)。请使用 `https://api.devin.ai` 作为基础 URL。有关身份验证和服务用户的指导，请参阅 [V3 API 概述](https://docs.devin.ai/zh/api-reference/v3/overview.md)。

预算作用域的集合端点需在路径中指定预算：`/v3beta1/enterprise/usage-policies/budgets/{budget_id}/...`。针对单个层级或请求的端点 (`/tiers/{tier_id}`、`/requests/{request_id}`) 会根据该层级或请求确定所属预算，因此与 account-wide 端点使用相同的路径。

### PATCH 语义

对于 `PATCH` 端点：

* 省略的字段保持不变。
* 设为 `null` 的字段将被清除。
* 设为具体值的字段将被创建或更新。

## 预算端点

### 列出预算

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets
```

以分页列表形式返回该账户的所有预算，包括活跃预算和已归档预算。每个预算的结构如下：

```json theme={null}
{
  "budget_id": "budget-abc123",
  "name": "Engineering",
  "parent_budget_id": "budget-root",
  "org_ids": ["org-xyz789"],
  "status": "active",
  "cycle_acu_limit": 2000,
  "temporary_cycle_acu_limit": null
}
```

* `budget_id`：在预算作用域路径中使用的标识符。
* `parent_budget_id`：父预算；账户的根级预算此值为 `null`。
* `org_ids`：已关联到此预算的组织，其用量计入该预算。未关联任何组织时为空。
* `status`：`active` 或 `archived`。
* `cycle_acu_limit`：该预算在每个月度计费周期内，对计入其自身及所有下级预算的 ACU 消耗量设定的上限；`null` 表示不设上限。
* `temporary_cycle_acu_limit`：在当前月度计费周期结束前覆盖 `cycle_acu_limit` 的临时上限；无生效中的临时上限时为 `null`。

### 更新预算

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/budgets/{budget_id}
```

部分更新：省略的字段保持不变，传入 `null` 则清除对应的限额。至少需要提供一个字段。

* `parent_budget_id`：将该预算连同其子预算移至另一个活跃预算之下。根级预算不可移动，且预算最多只能嵌套三级。
* `cycle_acu_limit`、`temporary_cycle_acu_limit`：该预算的限额，含义与列表响应中的相同。

**请求体 — 设置限额并为本月临时提高额度**

```json theme={null}
{
  "cycle_acu_limit": 2000,
  "temporary_cycle_acu_limit": 2500
}
```

**请求体——移除限额**

```json theme={null}
{
  "cycle_acu_limit": null,
  "temporary_cycle_acu_limit": null
}
```

**请求体——将该预算移至另一个预算下**

```json theme={null}
{
  "parent_budget_id": "budget-platform"
}
```

返回更新后的预算。再次设置 `temporary_cycle_acu_limit` 会在当前周期窗口内重新开始计算该限额。对于仅关联了一个组织的预算，`cycle_acu_limit` 也会同时作为该组织的 ACU 限额。

## 层级端点

### 列出层级

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/tiers
```

按优先级顺序返回该预算各层级的分页列表：`priority` 最高的排在最前，同一优先级下最新创建的层级排在最前。每个层级的结构如下：

```json theme={null}
{
  "tier_id": "tier-abc123",
  "name": "Engineers",
  "is_default": true,
  "cycle_acu_limit": 500,
  "policy": "manual",
  "max_limit": null,
  "priority": 0,
  "member_count": 42,
  "created_at": 1735689600
}
```

* `is_default`：该层级是否为预算的默认层级。
* `cycle_acu_limit`：每个成员每个周期的默认 ACU 限额；`null` 表示无上限。
* `policy`：该层级下提升限额请求的处理方式——`unconditional` 和 `conditional` 会在 `max_limit` 范围内批准，`manual` 则需要管理员审查。
* `max_limit`：提升限额请求可获批准的最高限额；`null` 表示批准时不设上限。当 `cycle_acu_limit` 为 `null` 时，该值始终为 `null`。
* `priority`：用于对用户所属的多个 IdP 组映射的层级进行排序——值最高者生效，值相同时以最新创建的层级为准。对用户的显式分配优先于该排序，且默认层级不参与排序。
* `member_count`：当前处于该层级的用户数。对于默认层级，该值统计所有未归属其他层级的预算成员。

### 创建层级

```http theme={null}
POST /v3beta1/enterprise/usage-policies/budgets/{budget_id}/tiers
```

**请求体**

```json theme={null}
{
  "name": "Engineers",
  "cycle_acu_limit": 500,
  "policy": "manual"
}
```

预算中创建的第一个层级会自动成为该预算的默认层级。成功时返回 HTTP `201`，并附带新创建的层级。

### 获取层级

```http theme={null}
GET /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

### 更新一个层级

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

部分更新；未提供的字段保持不变。

```json theme={null}
{
  "name": "Engineering",
  "cycle_acu_limit": 750
}
```

### 删除层级

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

成功时返回 HTTP `204`。默认层级无法删除 (需先将其他层级设为默认层级) 。若层级中仍有用户，须先将其移至其他层级，并先移除所有指向该层级的 IdP 组映射。

## 层级用户端点

### 列出某个层级的用户

```http theme={null}
GET /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users
```

以分页列表形式返回该层级的用户及其解析后的限额。对于默认层级，该列表包含所有不属于其他层级的预算成员：

```json theme={null}
{
  "user_id": "user_abc123",
  "name": "Ada Lovelace",
  "email": "ada@example.com",
  "cycle_acu_limit_override": null,
  "temporary_cycle_acu_limit": 800,
  "effective_cycle_acu_limit": 800,
  "limit_source": "temporary_override",
  "membership": "explicit"
}
```

* `cycle_acu_limit_override`：该用户的永久覆盖设置 (如有) 。
* `temporary_cycle_acu_limit`：该用户的临时覆盖，仅在其于当前月度计费周期内生效时返回。
* `effective_cycle_acu_limit`：当前对该用户强制执行的限额；`null` 表示无上限。
* `limit_source`：有效限额的来源，可为 `override` (永久) 、`temporary_override` 或 `tier`。
* `membership`：该用户归属此层级的原因，可为 `explicit` (直接分配) 、`idp_group` (通过其最终生效的 IdP 组映射) 或 `default` (回退到默认层级) 。

### 将用户分配到层级

```http theme={null}
PUT /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users/{user_id}
```

此操作具有幂等性。成功时返回 HTTP `204`。将用户从其他层级移入时，会清除该用户的所有用户级覆盖设置，使其默认继承目标层级的限额。

### 从层级中移除用户

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users/{user_id}
```

移除该用户的显式层级分配 (以及所有覆盖设置) 。此后，该用户将解析为其 IdP 组映射的层级 (如有) ；若无，则解析为默认层级。成功时返回 HTTP `204`。

## 用户端点

### 获取用户的限额

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/users/{user_id}
```

返回该用户在预算内解析后的层级、限额以及待处理的请求。除上文所述的[层级用户字段](#list-a-tiers-users)外，还包括：

```json theme={null}
{
  "tier_id": "tier-abc123",
  "tier_name": "Engineers",
  "tier_cycle_acu_limit": 500,
  "pending_request_id": null,
  "pending_request_cycle_acu_limit": null
}
```

* `tier_id` / `tier_name`：用户限额所依据的层级 (解析自显式分配、IdP 组映射或默认层级) ；若预算未设置层级，则为 `null`。
* `tier_cycle_acu_limit`：该层级在应用任何覆盖设置之前的自身限额；`null` 表示无上限。
* `pending_request_id` / `pending_request_cycle_acu_limit`：用户待处理的提升限额请求及其所申请的限额 (如有) 。

### 设置或清除用户的覆盖设置

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/budgets/{budget_id}/users/{user_id}
```

用户作用域：目标用户只需是预算成员即可，不涉及层级，也不会更改该用户的层级分配。

**请求体 — 设置临时覆盖**

```json theme={null}
{
  "cycle_acu_limit": 800,
  "kind": "temporary"
}
```

设置值时必须指定 `kind`：`permanent` 永不过期；`temporary` 在当前月度计费周期结束时过期。

**请求体 — 清除所有覆盖**

```json theme={null}
{
  "cycle_acu_limit": null
}
```

调用成功时，该端点返回 HTTP `204`。

## IdP 组端点

将 IdP 组映射到层级后，组成员将自动继承该层级。映射根据组成员关系实时解析，绝不会更改用户的显式层级分配——显式分配始终优先。如果用户属于多个已映射的组，则解析为 highest-ranked 的已映射层级 (即层级 `priority` 最高者；若优先级相同，则以最新创建的层级为准) 。

### 列出 IdP 组映射

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups
```

以分页列表形式返回该预算的组到层级映射，按创建时间从早到晚排序。使用 `?tier_id=` 进行过滤，可仅列出映射到某一层级的组：

```json theme={null}
{
  "idp_group_id": "grp_abc123",
  "idp_group_name": "Engineering",
  "tier_id": "tier-abc123"
}
```

### 获取 IdP 组的映射

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups/{idp_group_name}
```

如果该组在预算中没有映射，则返回 HTTP `404`。

### 将 IdP 组映射到使用层级

```http theme={null}
PUT /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups/{idp_group_name}
```

**请求体**

```json theme={null}
{
  "tier_id": "tier-abc123"
}
```

幂等的 upsert 操作。该层级必须属于此预算。在同一预算中，每个组最多映射到一个层级，因此对已映射的组再次执行映射，会将其移至指定的层级。

### 取消映射 IdP 组

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups/{idp_group_name}
```

成功时返回 HTTP `204`。该已映射层级将不再适用于该组的成员；既没有显式分配、也没有其他已映射层级的用户将回退到默认层级。

## 提升限额请求端点

用户可以申请提高每个周期的限额，具体处理方式取决于请求者所在层级的 `policy`：`unconditional` 和 `conditional` 会在该层级的 `max_limit` 范围内自动批准，而 `manual` 则会将请求挂起，等待管理员通过以下端点进行审查。

### 列出提升限额请求

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/requests
```

以分页列表形式返回该预算下的申请，可通过 `?status=` (`pending`、`approved`、`denied`、`expired`) 和 `?user_id=` 进行过滤：

```json theme={null}
{
  "request_id": 42,
  "user_id": "user_abc123",
  "name": "Ada Lovelace",
  "email": "ada@example.com",
  "tier_id": "tier-abc123",
  "tier_name": "Engineers",
  "current_cycle_acu_limit": 500,
  "requested_cycle_acu_limit": 800,
  "message": "Wrapping up a large migration this month",
  "status": "pending",
  "created_at": 1735689600,
  "reviewed_at": null,
  "reviewer": null
}
```

* `tier_id` / `tier_name`：请求者在该预算中所属的层级；若预算未设置层级，则为 `null`。
* `current_cycle_acu_limit`：当前对请求者强制执行的限额；`null` 表示无上限。
* `status`：`expired` 表示该请求在所属账单周期结束时仍处于待处理状态。
* `reviewer`：审查该请求的管理员；请求待处理期间为 `null`。

### 获取提升限额请求

```http theme={null}
GET /v3beta1/enterprise/usage-policies/requests/{request_id}
```

### 批准提升限额请求

```http theme={null}
POST /v3beta1/enterprise/usage-policies/requests/{request_id}/approve
```

以**临时覆盖**的形式授予所请求的限额，该临时覆盖将在当前月度计费周期结束时失效。也可以选择授予不同的限额：

```json theme={null}
{
  "cycle_acu_limit": 700
}
```

返回更新后的请求。如果该请求已被审查过，或请求者已不再是账户成员，则返回 HTTP `409`。

### 拒绝提升限额请求

```http theme={null}
POST /v3beta1/enterprise/usage-policies/requests/{request_id}/deny
```

返回更新后的请求；如果该请求已审查过，则返回 HTTP `409`。

## 工作流程示例

### 设置预算的层级

先找到该预算，将其上限设为每月 2,000 ACU，然后创建一个默认层级，让该预算的每位成员每月都有 500 ACU 的上限：

```bash theme={null}
curl "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets" \
  -H "Authorization: Bearer <token>"

curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"cycle_acu_limit": 2000}'

curl -X POST "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123/tiers" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Standard", "cycle_acu_limit": 500, "policy": "manual"}'
```

将某个 IdP 组映射到该层级，并为一位用户临时提高额度，有效期至本月底：

```bash theme={null}
curl -X PUT "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123/idp-groups/Engineering" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"tier_id": "tier-abc123"}'

curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123/users/user_abc123" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"cycle_acu_limit": 800, "kind": "temporary"}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.