Skip to main content
PUT
組織のデフォルトプラットフォームを設定
新しいセッションに適用される、組織全体のデフォルト配置先を設定します。これは webapp の Settings > Devin > Default platform と同じ設定です。platform を明示的に指定せずに作成されたセッションでは、作成者の個人用デフォルトが優先され、それが未設定の場合にこの設定が適用されます。

権限

組織レベルで ManageOrgSettings 権限を持つサービスユーザーまたはパーソナルアクセストークンが必要です。

リクエストフィールド

次のいずれか一方のみを送信できます (省略も可) 。
  • platform: 組織に設定されているホスト型プラットフォームのラベル (例: linux、windows、macos) 、または共有 outpost プールの名前。大文字と小文字は区別されません。名前が両方に一致する場合は、プラットフォームが優先されます。
  • outpost_pool_id: 組織で利用できる共有 outpost プールの ID。
デフォルトを解除するには、空の JSON オブジェクト ({}) を送信するか、両方のフィールドに null を指定して送信します。リクエストボディは必須です。 指定できるのは共有 outpost プールのみです。個人用アウトポストでは所有者しかセッションを開始できないため、組織のデフォルトには設定できません。

Outposts 専用の組織

Enterprise が Outposts 専用モードの場合、受け付けられるのは outpost プールのみです。ホスト型プラットフォームのラベルを指定すると 400 が返されます。

エラー

  • 400: platform が設定済みのプラットフォームや共有 outpost プールのいずれにも一致しない場合、複数の outpost プールに一致する場合、または Outposts 専用の組織でホスト型プラットフォームを指定した場合。あるいは、outpost_pool_id が組織で利用可能な共有プールではない場合。エラー本文には、利用可能なプラットフォームと outpost プールの一覧が含まれます。
  • 403: 呼び出し元に ManageOrgSettings 権限がない場合。
  • 422: platform と outpost_pool_id の両方が指定されている場合。

使用例

承認

Authorization
string
header
必須

サービスユーザーの認証情報(接頭辞: cog_)

パスパラメータ

org_id
string
必須

組織ID(プレフィックス: org-)

例:

"org-abc123def456"

ボディ

application/json

新しいセッションに適用される、組織のデフォルトの配置先を設定します。

platform と outpost_pool_id は、多くても一方のみを指定してください。デフォルトを解除するには、両方を null として送信してください(例:{})。

outpost_pool_id
string | null

組織で利用可能な共有アウトポストプールの ID。

Maximum string length: 128
platform
string | null

組織に設定されたホスト型プラットフォームのラベル(例:'linux'、'windows'、'macos')または共有アウトポストプールの名前。大文字と小文字は区別されず、名前が両方に一致する場合はプラットフォームが優先されます。認識されない値は 400 エラーで拒否され、利用可能なプラットフォームとアウトポストプールが一覧表示されます。

Maximum string length: 128

レスポンス

成功レスポンス

新しいセッションに適用される、組織のデフォルトの配置先。

outpost_pool_id
string | null
必須

新しいセッションのデフォルトの実行先となるアウトポストプール。デフォルトがホスト型プラットフォームの場合、または未設定の場合は Null。

outpost_pool_name
string | null
必須

デフォルトのアウトポストプールの名前。デフォルトがアウトポストプールでない場合、または組織でそのプールが利用できなくなった場合は Null。

platform
string | null
必須

新しいセッションのデフォルトの実行先となるホスト型プラットフォームのラベル(例:'linux'、'windows')。デフォルトがアウトポストプールの場合、または未設定の場合は Null。