Skip to main content
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 ロールに含まれています。この権限がないサービスユーザーは、モデルの一覧は取得できますが、このエンドポイントでは 403 が返されます。

リクエスト

string
必須
現在の状態を反映した GET /api/v2alpha/models レスポンスの ETag ヘッダー。必須です。* は使用できません。
string[]
必須
ユーザーが選択できるモデルの UID (例:["claude-sonnet-4-5"]) 。タグのみでモデルを許可する場合は [] を渡します。
string[]
必須
ユーザーが選択できるモデルのタグ。provider-anthropic や provider-openai などのプロバイダータグも指定できます。指定したモデル UID のみを許可する場合は [] を渡します。
両方のフィールドが必須です。未定義のフィールドを含むリクエストは拒否されます。

リクエスト例

レスポンス

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

エラーレスポンス

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