メインコンテンツへスキップ
PUT
Devin Desktop のモデルの許可リストを更新する

概要

あなたの Team のモデルの許可リストを置き換えます。これは、管理者が Devin Desktop の組織のコントロールで管理する設定と同じものです。リクエストボディには、望ましい状態全体を指定します。2 つのリストは、保存済みのリストを上書きします。 まだ確認していない変更を誤って上書きしないよう、リクエストの If-Match には、List Models のレスポンスで取得した ETag を指定する必要があります。そのレスポンス以降に許可リスト、利用可能なモデル、またはその料金が変更されている場合、更新は 412 で拒否されます。その場合は、モデル一覧を再取得してください。
このエンドポイントはアルファ版 (v2alpha) です。リクエストおよびレスポンスの形式は変更される可能性があります。

認証

Authorization ヘッダーに APIキーを指定します:
Devin のサービスユーザーAPIキー (cog_...) を利用してください。必要な権限は List Models と同じです。サービスユーザーのロールには Use Devin Desktop 権限と Windsurf 管理者 権限 (account.windsurf.admin) が必要です。これらの権限は built-in の Account Admin ロールに含まれています。

リクエスト

string
必須
現在の状態を反映した GET /api/v2alpha/models レスポンスの ETag ヘッダー (org_id を渡す場合は、同じ org_id を指定したレスポンスのもの) 。必須です。* は使用できません。
string[]
必須
ユーザーが選択できるモデルの UID (例:["claude-sonnet-4-5"]) 。タグのみでモデルを許可する場合は [] を渡します。
string[]
必須
ユーザーが選択できるモデルのタグ。provider-anthropic や provider-openai などのプロバイダータグも指定できます。指定したモデル UID のみを許可する場合は [] を渡します。
string
アカウント全体の許可リストではなく、アカウント内の特定の組織に対する許可リストの上書き設定を置き換えます。対象の組織に上書き設定がない場合は新規に作成されます。また、If-Match には GET /api/v2alpha/models?org_id=<org_id> レスポンスの ETag を指定する必要があります。アカウント全体の許可リストを置き換える場合は指定しないでください。
allowed_model_uids と allowed_model_tags は必須です。未定義のフィールドを含むリクエストは拒否されます。org_id はリクエストボディでのみ受け付けられ、クエリパラメーターとしては指定できません。

リクエスト例

レスポンス

成功した場合、レスポンスは List Models と同じ形式で、新しい許可リストが適用された内容になります。具体的には、allowed flag を含むすべてのモデル、保存済みの allowed_model_uids と allowed_model_tags、および新しい ETag ヘッダーが返されます。

エラーレスポンス

エラーは {"error": "<message>"} の形式で返されます。