Copilot モデルポリシー管理用の REST API エンドポイント

Get model policies for an organization

Use this endpoint to retrieve the effective Copilot model policy for every model available to an organization, whether explicitly configured or determined by default availability.

For a model without an effective explicit policy that is eligible for default availability, the enterprise default is used when it is configured. Otherwise, the organization's default is used. A model that is not eligible for default availability and has no effective explicit policy is disabled. For more information, see About default availability of Copilot models.

The organization must either be independent or belong to an enterprise that is not using enterprise teams for model policy.

Organization owners can use this endpoint.

OAuth app tokens and personal access tokens (classic) need the admin:org or repo scope to use this endpoint. Organization SAML authorization and OAuth app access restrictions also apply.

"Get model policies for an organization" のきめ細かいアクセストークン

このエンドポイントは、次の粒度の細かいトークンの種類で動作します:

粒度の細かいトークンには次のアクセス許可セットが設定されている必要があります:

"Administration" organization permissions (write)

"Get model policies for an organization" のパラメーター

ヘッダー
名前, タイプ, 説明
`accept` string Setting to `application/vnd.github+json` is recommended.

パスパラメーター
名前, タイプ, 説明
`org` string 必須 The organization name. The name is not case sensitive.

"Get model policies for an organization" の HTTP 応答状態コード

状態コード	説明
`200`	OK
`401`	Requires authentication
`403`	Forbidden
`404`	Resource not found

"Get model policies for an organization" のコードサンプル

GHE.com でGitHubにアクセスする場合は、api.github.com を、api.SUBDOMAIN.ghe.com にある企業の専用サブドメインに置き換えます。

要求の例

get/orgs/{org}/copilot/model-policies

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/orgs/ORG/copilot/model-policies

OK

Status: 200

{
  "default_availability": {
    "policy_state": "disabled",
    "editable": true
  },
  "models": [
    {
      "model_name": "gpt-5.6-sol",
      "display_name": "OpenAI GPT-5.6 Sol",
      "policy_state": "enabled"
    },
    {
      "model_name": "gpt-5",
      "display_name": "GPT-5",
      "policy_state": "disabled"
    }
  ]
}

Update model policies for an organization

Use this endpoint to set explicit Copilot model policies and default availability for an organization. All policies in the request are updated atomically, meaning if any change in the request cannot be applied, none of the changes are saved.

Use the model_name values returned by the "Get model policies for an organization" endpoint. Models with an inherited enterprise policy are locked and cannot be updated. Default availability cannot be updated when its editable value is false.

The response contains the effective policies for all models available to the organization, not only the policies updated by the request.

The organization must either be independent or belong to an enterprise that is not using enterprise teams for model policy.

Organization owners can use this endpoint.

OAuth app tokens and personal access tokens (classic) need the admin:org or repo scope to use this endpoint. Organization SAML authorization and OAuth app access restrictions apply.

"Update model policies for an organization" のきめ細かいアクセストークン

このエンドポイントは、次の粒度の細かいトークンの種類で動作します:

粒度の細かいトークンには次のアクセス許可セットが設定されている必要があります:

"Administration" organization permissions (write)

"Update model policies for an organization" のパラメーター

ヘッダー
名前, タイプ, 説明
`accept` string Setting to `application/vnd.github+json` is recommended.

パスパラメーター
名前, タイプ, 説明
`org` string 必須 The organization name. The name is not case sensitive.

名前, タイプ, 説明

default_availability object

The organization's default availability for eligible models without an explicit policy. It cannot be updated when it is inherited from the enterprise.

Properties of default_availability

名前, タイプ, 説明
`policy_state` string 必須次のいずれかにできます: `enabled`, `disabled`

models array of objects

The model policies to update. Each model_name must be unique.

Properties of models

名前, タイプ, 説明
`model_name` string 必須 The public identifier of a model returned by the get endpoint.
`policy_state` string 必須 The explicit policy state to set for the organization. 次のいずれかにできます: `enabled`, `disabled`

"Update model policies for an organization" の HTTP 応答状態コード

状態コード	説明
`200`	OK
`401`	Requires authentication
`403`	Forbidden
`404`	Resource not found
`422`	Validation failed, or the endpoint has been spammed.

"Update model policies for an organization" のコードサンプル

GHE.com でGitHubにアクセスする場合は、api.github.com を、api.SUBDOMAIN.ghe.com にある企業の専用サブドメインに置き換えます。

要求の例

patch/orgs/{org}/copilot/model-policies

curl -L \
  -X PATCH \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/orgs/ORG/copilot/model-policies \
  -d '{"default_availability":{"policy_state":"disabled"},"models":[{"model_name":"gpt-5.6-sol","policy_state":"enabled"},{"model_name":"gpt-5","policy_state":"disabled"}]}'

OK

Status: 200

{
  "default_availability": {
    "policy_state": "disabled",
    "editable": true
  },
  "models": [
    {
      "model_name": "gpt-5.6-sol",
      "display_name": "OpenAI GPT-5.6 Sol",
      "policy_state": "enabled"
    },
    {
      "model_name": "gpt-5",
      "display_name": "GPT-5",
      "policy_state": "disabled"
    }
  ]
}

Copilot モデルポリシー管理用の REST API エンドポイント

Get model policies for an organization

"Get model policies for an organization" のきめ細かいアクセストークン

"Get model policies for an organization" のパラメーター

"Get model policies for an organization" の HTTP 応答状態コード

"Get model policies for an organization" のコードサンプル

要求の例

OK

Update model policies for an organization

"Update model policies for an organization" のきめ細かいアクセストークン

"Update model policies for an organization" のパラメーター

"Update model policies for an organization" の HTTP 応答状態コード

"Update model policies for an organization" のコードサンプル

要求の例

OK

このドキュメントは役に立ちましたか?

まだ助けが必要ですか？

Copilot モデル ポリシー管理用の REST API エンドポイント

要求の例

OK

要求の例

OK

Copilot モデルポリシー管理用の REST API エンドポイント