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

# Update an auth server scope

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

Update a scope for a given auth server

## 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

## 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
  - `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

- **2025-06-05** `a0a9c5c8afa2` — 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/kong/apis/konnect-api-beta.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kong/konnect-api-beta/revisions/a0a9c5c8afa2/schema)