組織レベルのACU limit

Devin 組織の月次ACU予算を設定し、APIからlimitを管理し、使用量が各組織にどのように割り当てられるかを確認できます。

組織レベルのlimitは、cloud Devin セッション、Devin Review、Devin Desktop、Windsurf JetBrains、Devin CLI を通じた組織全体の月次ACU消費量にlimitを設けるものです。

Enterprise 内の各組織にそれぞれ独自のlimitを設定できるため、管理者はチームやプロジェクト単位で予算を配分できます。limitは Settings > Organizations (Enterprise billing を参照) または以下のAPIから管理します。

limitは、現在の月次請求期間における合計消費量に適用されます。たとえば、limitが5,000 ACUで、すでに3,000 ACUを消費している場合、その組織の残りは2,000 ACUです。limitを変更しても使用量はリセットされません。

組織レベルのlimitとユーザーレベルのlimitは、それぞれ独立して適用されます。ユーザーのlimitと該当する組織のlimitのいずれかに達すると、新しい作業はブロックされます。

請求先組織の帰属

使用量は、請求先となる組織のlimitに計上されます。

• cloud Devin セッション は、セッションが実行される組織に計上されます。
• Devin Review は、そのレビューの請求先組織に計上されます。
• Devin Desktop、Windsurf JetBrains、Devin CLI は、ユーザーの請求先組織に計上されます。

管理者は、Settings > Members またはAPIを通じて、ユーザーの請求先組織を割り当てられます。明示的な割り当てがない場合は、直接メンバーシップまたはIdentity Providerのグループ割り当てを通じてユーザーがアクセスできる最初の組織に決定されます。

ユーザーの請求先組織によって、適用されるローカルエージェントのコントロールも決まります。

APIを通じて請求先組織を割り当てるには、ユーザー設定エンドポイントを利用します。そのbilling_org_idフィールドは引き続きサポートされています。

curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/users/user_abc123/consumption/acu-limits" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"local_agent": {"billing_org_id": "org-xyz789"}}'

組織エンドポイント

ベースURLには https://api.devin.ai を利用してください。認証と権限については、ACU limit を参照してください。

これらのエンドポイントはベータ版 (/v3beta1) であり、公開されているOpenAPI仕様には含まれていません。

組織のlimitを取得する

GET /v3beta1/enterprise/organizations/{org_id}/consumption/acu-limits

HTTP 200 を返し、組織の limit が cycle_acu_limit に含まれます:

{
  "cycle_acu_limit": 5000
}

組織の limit が設定されていない場合、cycle_acu_limit は省略されます。

レスポンスには、非推奨な cloud_agent および local_agent フィールドが含まれる場合もあります。新しい統合では cycle_acu_limit を利用してください。

組織のlimitを更新する

PATCH /v3beta1/enterprise/organizations/{org_id}/consumption/acu-limits

リクエストボディ — limitを設定

{
  "cycle_acu_limit": 5000
}

リクエストボディ — limitを解除

{
  "cycle_acu_limit": null
}

cycle_acu_limit	効果
正の整数	各月次請求期間における組織全体の ACU 予算を設定します
0	組織の新規使用量をブロックします
null	組織のlimitを解除します
省略	limitを変更しません

成功時、エンドポイントは HTTP 204 No Content を返します。cycle_acu_limit と非推奨のエージェントブロックのいずれかを同一のリクエストに含めないでください。

組織のlimitを削除する

DELETE /v3beta1/enterprise/organizations/{org_id}/consumption/acu-limits

組織のACU limitを解除します。これは cycle_acu_limit に null を設定することと同じです。このエンドポイントは、成功時に HTTP 204 No Content を返します。

組織のlimitを解除しても、ユーザーレベルの上限とEnterpriseの請求条件は引き続き適用されます。

エラー

ステータス	意味
400	PATCH リクエストで cycle_acu_limit と cloud_agent または local_agent を同時に指定している
403	トークンに必要な権限がありません
404	対象の組織が Enterprise 内に見つかりません
409	この組織では cycle_acu_limit を利用できません。アカウントチームにお問い合わせください
422	リクエストの値が無効です。cycle_acu_limit は 0 以上の整数または null である必要があります

例: 組織の予算を設定する

組織に5,000 ACUのlimitを設定します。

curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/organizations/org-xyz789/consumption/acu-limits" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"cycle_acu_limit": 5000}'

よくある質問

組織がlimitに達するとどうなりますか？

その組織に課金される新規の作業は、管理者がlimitを引き上げるか解除するか、次の月次請求期間で使用量がリセットされるまでブロックされます。

limitの変更はどれくらいで反映されますか？

各製品に変更が反映されるまで、約5分お待ちください。limitの変更は Enterprise の監査ログに記録されます。