---
title: "Update an auth server scope"
method: PATCH
path: "/v1/auth-servers/{authServerId}/scopes/{scopeId}"
tags: ["Auth Server Scopes"]
---

# Update an auth server scope

`PATCH /v1/auth-servers/{authServerId}/scopes/{scopeId}`

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v1/auth-servers/{authServerId}/scopes/{scopeId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Update a scope for a given auth server.

## Path parameters

- `authServerId` string, uuid, required
- `scopeId` string, uuid, required

## Request body

- object
  - `name` string: The name of the scope
  - `description` string: Description of the scope
  - `default` boolean: Specifies whether the scope is included by default in access tokens without being explicitly requested by the client. If the scope is not allowed by the client, it will not be included in the access token.
  - `include_in_metadata` boolean: Specifies whether to include the scope in the metadata document
  - `enabled` boolean: Specifies whether the scope is enabled. If the scope is not enabled, it cannot be requested by clients and will not be included in the access token.

## Response `200`

A scope

- Scope
  - `id` string, uuid, required: The ID of the scope
  - `name` string, required: The name of the scope
  - `description` string, required: Description of the scope
  - `default` boolean, required: Specifies whether the scope is included by default in access tokens without being explicitly requested by the client. If the scope is not allowed by the client, it will not be included in the access token.
  - `include_in_metadata` boolean, required: Specifies whether to include the scope in the metadata document
  - `enabled` boolean, required: Specifies whether the scope is enabled. If the scope is not enabled, it cannot be requested by clients and will not be included in the access token.
  - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
  - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity update date.

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `409`: Conflict

## Changes

- **2026-11-02** `7e077577b247`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v1/auth-servers/:authServerId/scopes/:scopeId/patch.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) - [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/3b071797f6e4?raw)
