ユーザーレベルのACU上限

ユーザーレベルの上限はベータ機能であり、Enterpriseでこの機能を有効にする必要があります。有効にするには、アカウントチームにお問い合わせください。

ユーザーレベルの上限では、ユーザーのローカルとクラウドのACU使用量の合計を制限します。cloud Devin セッション、Devin Desktop、Windsurf JetBrains、Devin CLIはすべて同じ上限にカウントされます。ユーザーが上限に達すると、上限が引き上げられるか、次の月次期間に使用量がリセットされるまで、これらの対象で新しい作業を開始できません。ティアとユーザーレベルの上限は、web appのEnterprise Settingsにある使用量ポリシー (使用量ポリシーガイドを参照) 、または以下のusage-policiesエンドポイントで管理できます。ユーザーレベルの上限はティアで管理します。ティアは、メンバー間で共有される名前付きのアカウント全体のデフォルト上限です。

ユーザーがティアに属する方法は3つあります。adminによる明示的な割り当て、IdPグループマッピングによる割り当て (グループはティアにマッピングされ、メンバーは明示的に別のティアに割り当てられない限り、そのティアを継承します) 、またはデフォルトティアへのフォールバックです。各アカウントでは、1つのティアをデフォルトティアとして指定できます。他のティアに割り当てられていないすべてのアカウントメンバーは、そのティアに属します。個別の「デフォルトユーザー上限」はありません。代わりにデフォルトティアを設定してください。
個々のユーザーには、永続的 (期限なし) または一時的 (現在の月次請求期間の終了時に失効) のユーザーオーバーライドを設定できます。ユーザーオーバーライドはユーザー単位であり、設定してもユーザーのティア割り当ては変更されません。
ユーザーの実効上限は、次の順序で決まります。永続的なオーバーライド、有効な一時的オーバーライド、明示的に割り当てられたティアのcycle_acu_limit、最上位のIdPグループマッピング済みティアの上限、デフォルトティアの上限です。上限がnullの場合は上限がないことを意味します。
ユーザーは上限の引き上げをリクエストできます。adminはこれらの上限引き上げリクエストを確認します。各ティアのpolicyにより、リクエストを自動承認するか、手動レビューに回すかが決まります。

ユーザーレベルの上限は組織レベルの上限とは独立しており、どちらかの上限に達している場合はリクエストがブロックされます。このページのすべてのエンドポイントに共通する認証、権限、PATCHのセマンティクスについては、ACU上限を参照してください。

ティア導入前のユーザーごとの上限およびデフォルトユーザー上限エンドポイントは非推奨です。レガシーユーザーACU上限エンドポイントを参照してください。

ティアエンドポイント

ティアの一覧を取得

GET /v3beta1/enterprise/usage-policies/tiers

優先順位順にページ分割されたティアのリストを返します。priority が最も高いものから順に、同じ優先順位内では最も新しいティアから順に返されます。各ティアは次のとおりです。

{
  "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 では管理者によるレビューが必要です。conditional ポリシー (効率性に基づく自動承認) を利用するには、別途有効化が必要です。アカウントチームにお問い合わせください。
max_limit: 引き上げリクエストが承認される最大上限。null は上限なしで承認されることを意味します。cycle_acu_limit が null の場合は常に null です。
priority: ユーザーのIdPグループマッピングによるティア間の優先順位。値が最も高いティアが優先され、同値の場合は最も新しいティアが優先されます。この順位付けは優先順位のみを示すものであり、優先順位が高いティアの cycle_acu_limit が低い場合があります。明示的なユーザー割り当てはこの優先順位を上書きし、デフォルトティアは優先順位付けの対象になりません。
member_count: 現在ティアに含まれるユーザー数。明示的に割り当てられたユーザーと、IdPグループマッピングによって割り当てられたユーザーの合計です。デフォルトティアでは、他のティアに含まれないすべてのアカウントメンバーがカウントされます。

web appの使用量ポリシーで、デフォルトティアとティアの優先順位を設定します。

ティアを作成する

POST /v3beta1/enterprise/usage-policies/tiers

リクエストボディ

{
  "name": "Engineers",
  "cycle_acu_limit": 500,
  "policy": "manual"
}

アカウントで最初に作成されたティアが自動的にデフォルトティアになります。作成されたティアを含む HTTP 201 を返します。

ティアを取得する

GET /v3beta1/enterprise/usage-policies/tiers/{tier_id}

ティアを更新する

PATCH /v3beta1/enterprise/usage-policies/tiers/{tier_id}

部分更新です。省略したフィールドは変更されません。デフォルトティアまたはティアの優先順位を変更するには、web app の 使用量ポリシー で設定してください。

{
  "name": "Engineering",
  "cycle_acu_limit": 750
}

ティアを削除

DELETE /v3beta1/enterprise/usage-policies/tiers/{tier_id}

成功時は HTTP 204 を返します。デフォルトティアは削除できません (先に別のティアを昇格させてください) 。ユーザーが残っているティアを削除するには、先にユーザーを移動し、そのティアに対する IdP グループマッピングをすべて削除する必要があります。

ティアユーザーのエンドポイント

ティアのユーザー一覧を取得する

GET /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users

ティアに属するユーザー (明示的に割り当てられたユーザーと、IdPグループマッピングによって追加されたユーザー) およびそれぞれの解決済み上限を、ページネーション形式で返します。デフォルトティアでは、他のティアに属していないすべてのアカウントメンバーが対象です：

{
  "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 (デフォルトティアへのフォールバック) 。

ユーザーをティアに割り当てる

PUT /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users/{user_id}

冪等です。成功時は HTTP 204 を返します。別のティアからユーザーを移動すると、ユーザーオーバーライドはクリアされ、移動先ティアの limit を継承した状態になります。

ティアからユーザーを削除する

DELETE /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users/{user_id}

ユーザーの明示的なティア割り当て (およびオーバーライド) を解除し、デフォルトティアに戻します。成功時は HTTP 204 を返します。

ユーザーオーバーライドエンドポイント

ユーザーのオーバーライドを設定または解除する

PATCH /v3beta1/enterprise/usage-policies/users/{user_id}

ユーザースコープ: 対象はアカウントメンバーであればよく、ティアは関係しません。ユーザーのティア割り当てが変更されることもありません。明示的なティア割り当てがなく、オーバーライドのみが設定されているユーザーは、デフォルトティアのままです。 リクエストボディ — 一時的なオーバーライドを設定

{
  "cycle_acu_limit": 800,
  "kind": "temporary"
}

kind は値を設定する際に必須です。permanent は期限切れにならず、temporary は現在の月次請求期間の終了時に期限切れになります。 リクエストボディ — すべてのオーバーライドをクリア

{
  "cycle_acu_limit": null
}

エンドポイントは、成功時に HTTP 204 を返します。

IdP グループのエンドポイント

IdP グループをティアにマッピングすると、そのメンバーにはそのティアが自動的に継承されます。マッピングはグループメンバーシップに基づいてリアルタイムに解決され、ユーザーの明示的なティア割り当てが変更されることはありません。明示的な割り当てが常に優先されます。複数のマッピング済みグループに属するユーザーには、最上位のマッピング済みティアが適用されます (priority が最も高いティア。同順位の場合は最も新しいティア) 。

IdP グループマッピングの一覧

GET /v3beta1/enterprise/usage-policies/idp-groups

アカウントのグループとティアのマッピングを、古い順にページ分割して返します。?tier_id= でフィルタリングすると、特定のティアにマッピングされたグループのみを一覧表示できます。

{
  "idp_group_id": "grp_abc123",
  "idp_group_name": "Engineering",
  "tier_id": "tier-abc123"
}

IdPグループのマッピングを取得

GET /v3beta1/enterprise/usage-policies/idp-groups/{idp_group_name}

グループにマッピングがない場合、HTTP 404 を返します。

IdP グループをティアにマッピングする

PUT /v3beta1/enterprise/usage-policies/idp-groups/{idp_group_name}

リクエストボディ

{
  "tier_id": "tier-abc123"
}

冪等なアップサートです。グループは1つのティアにのみマッピングできるため、すでにマッピングされているグループをマッピングすると、指定したティアに移動します。

IdPグループのマッピングを解除する

DELETE /v3beta1/enterprise/usage-policies/idp-groups/{idp_group_name}

成功時は HTTP 204 を返します。マッピング済みティアはグループのメンバーに適用されなくなります。明示的な割り当てがなく、他にマッピング済みティアもないユーザーには、デフォルトティアが適用されます。

上限引き上げリクエストのエンドポイント

ユーザーは、サイクルごとの上限引き上げをリクエストできます。リクエスト者のティアのpolicyによって処理が決まり、unconditionalとconditionalではティアのmax_limitまで自動承認されます。manualでは、これらのエンドポイント (または web app の使用量ポリシー) を通じて管理者が確認するまで、リクエストは保留されます。

このページの他のエンドポイントとは異なり、上限引き上げリクエストを取得するには ManageBilling 権限が必要です。リクエストにはメンバーの識別情報と自由記述メッセージが含まれるため、管理者ワークフローのデータとして扱われます。

上限引き上げリクエストの一覧を取得する

GET /v3beta1/enterprise/usage-policies/requests

ページネーションされた一覧を返します。?status= (pending、approved、denied) および?user_id=で絞り込めます：

{
  "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: リクエスト者のティア (明示的な割り当て、IdPグループマッピング、またはデフォルトティア) 。accountにティアがない場合はnull。
current_cycle_acu_limit: リクエスト者に現在適用されている上限。nullは上限がないことを示します。
reviewer: リクエストをレビューしたAdmin。保留中の場合はnullです。

上限引き上げリクエストを取得

GET /v3beta1/enterprise/usage-policies/requests/{request_id}

上限引き上げリクエストを承認する

POST /v3beta1/enterprise/usage-policies/requests/{request_id}/approve

リクエストされた上限を、現在の月次請求期間の終了時に失効する一時的なオーバーライドとして付与します。必要に応じて、異なる上限を付与できます。

{
  "cycle_acu_limit": 700
}

更新後のリクエストを返します。リクエストがすでに確認済みである場合、またはリクエスト送信者がアカウントメンバーでなくなった場合は、HTTP 409 を返します。

上限引き上げリクエストを拒否する

POST /v3beta1/enterprise/usage-policies/requests/{request_id}/deny

更新後のリクエストを返します。すでにレビュー済みの場合は、HTTP 409 を返します。

ワークフローの例

デフォルト上限付きのティアを設定する

すべてのユーザーに月間500 ACUの上限を適用するデフォルトティアを作成します。

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

上限の高いティアを作成し、ユーザーを割り当てます：

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

curl -X PUT "https://api.devin.ai/v3beta1/enterprise/usage-policies/tiers/tier-abc123/users/user_abc123" \
  -H "Authorization: Bearer <token>"

月末まで、ユーザーの上限を一時的に引き上げます：

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

IdP グループを上限の高いティアにマッピングし、保留中の上限引き上げリクエストを確認します：

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

curl -X POST "https://api.devin.ai/v3beta1/enterprise/usage-policies/requests/42/approve" \
  -H "Authorization: Bearer <token>"

よくある質問

ユーザーレベルの上限はどの製品に適用されますか？

ローカルとクラウドの使用量: cloud Devin セッションと、CLI および IDE (Devin Desktop、Windsurf JetBrains、Devin CLI) でのローカル使用量は、同一の上限に計上されます。

ユーザーの実効上限はどのように決まりますか？

永続的なオーバーライドが最優先され、次に有効な一時的なオーバーライド、ユーザーに明示的に割り当てられたティアの上限、IdP グループにマッピングされたティアのうち最上位のものの上限、デフォルトティアの上限の順に適用されます。すべてのレベルの上限が null の場合、ユーザーに上限はありません。

ユーザーオーバーライドはティアの上限に加算されますか？

いいえ。オーバーライドは、そのユーザーのティア上限を置き換えます。ティア上限が 500 ACU で、ユーザーに 200 ACU のオーバーライドがある場合、そのユーザーの実効上限は 200 ACU です。

永続的なオーバーライドと一時的なオーバーライドの違いは何ですか？

永続的なオーバーライドは期限切れになりません。一時的なオーバーライドは現在の月次請求期間の終了時に失効し、その後はユーザーのティア上限が適用されます。上限引き上げリクエストを承認すると、一時的なオーバーライドが付与されます。

デフォルトユーザー上限は引き続き存在しますか？

独立した設定としては存在しません。代わりにデフォルトティアの上限を設定してください。これは、他のティアに割り当てられていないすべてのアカウントメンバーに適用されます。レガシーのデフォルトユーザー上限エンドポイントでは、デフォルトティアの上限を読み書きするようになりました。

上限に達するとどうなりますか？

ローカルとクラウドのどちらでも、新しい作業はブロックされます。ユーザーは Enterprise 管理者に連絡して上限を調整するか、次の月次期間が始まるまで待つことができます。

Get Started

Essential Guidelines

Onboarding Devin

Working with Devin

Product Guides

Integrations

Admin

Release Notes

ユーザーレベルのACU上限

ティアエンドポイント

ティアの一覧を取得

ティアを作成する

ティアを取得する

ティアを更新する

ティアを削除

ティアユーザーのエンドポイント

ティアのユーザー一覧を取得する

ユーザーをティアに割り当てる

ティアからユーザーを削除する

ユーザーオーバーライドエンドポイント

ユーザーのオーバーライドを設定または解除する

IdP グループのエンドポイント

IdP グループマッピングの一覧

IdPグループのマッピングを取得

IdP グループをティアにマッピングする

IdPグループのマッピングを解除する

上限引き上げリクエストのエンドポイント

上限引き上げリクエストの一覧を取得する

上限引き上げリクエストを取得

上限引き上げリクエストを承認する

上限引き上げリクエストを拒否する

ワークフローの例

デフォルト上限付きのティアを設定する

よくある質問

​ティアエンドポイント

​ティアの一覧を取得

​ティアを作成する

​ティアを取得する

​ティアを更新する

​ティアを削除

​ティアユーザーのエンドポイント

​ティアのユーザー一覧を取得する

​ユーザーをティアに割り当てる

​ティアからユーザーを削除する

​ユーザーオーバーライドエンドポイント

​ユーザーのオーバーライドを設定または解除する

​IdP グループのエンドポイント

​IdP グループマッピングの一覧

​IdPグループのマッピングを取得

​IdP グループをティアにマッピングする

​IdPグループのマッピングを解除する

​上限引き上げリクエストのエンドポイント

​上限引き上げリクエストの一覧を取得する

​上限引き上げリクエストを取得

​上限引き上げリクエストを承認する

​上限引き上げリクエストを拒否する

​ワークフローの例

​デフォルト上限付きのティアを設定する

​よくある質問

ティアエンドポイント

ティアの一覧を取得

ティアを作成する

ティアを取得する

ティアを更新する

ティアを削除

ティアユーザーのエンドポイント

ティアのユーザー一覧を取得する

ユーザーをティアに割り当てる

ティアからユーザーを削除する

ユーザーオーバーライドエンドポイント

ユーザーのオーバーライドを設定または解除する

IdP グループのエンドポイント

IdP グループマッピングの一覧

IdPグループのマッピングを取得

IdP グループをティアにマッピングする

IdPグループのマッピングを解除する

上限引き上げリクエストのエンドポイント

上限引き上げリクエストの一覧を取得する

上限引き上げリクエストを取得

上限引き上げリクエストを承認する

上限引き上げリクエストを拒否する

ワークフローの例

デフォルト上限付きのティアを設定する

よくある質問