Update a scope

View as Markdown
PATCH
/resources/scopes/{scope_id}

Applies a partial update to the specified identity scope. Only fields included in the request are updated.

Authorization

API-Key
headerX-API-KEY<token>

MonoCloud APIs require authentication with an API key. Retrieve your key from the Tenant Settings section of the MonoCloud dashboard and include it in the request header as: X-API-Key: <your_api_key>

Path Parameters

scope_id*string

The unique identifier of the scope.

Request Body

application/json

The request payload used to update a scope.

TypeScript Definitions

Use the request body type in TypeScript.

Patch Scope Request: Used to update one or more properties of an existing scope.

Response Body

200

application/json

The scope was updated successfully

TypeScript Definitions

Use the response body type in TypeScript.

Scope Response: Represents a permission that can be requested by clients and evaluated during authorization.

Errors

401Unauthorized
403Forbidden

curl -X PATCH "https://your-domain.us.monocloud.com/api/resources/scopes/tQi5Nu2sg7TVB727UfHPT" \  -H "X-API-KEY: <token>" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "string",  "display_name": null,  "description": null,  "show_in_discovery_document": true,  "creation_time": 0,  "last_updated": 0,  "name": "string",  "required": true,  "emphasize": true,  "is_default": true,  "user_claims": [    {      "claim": "string",      "include_in_identity_token": true,      "include_in_user_info": true    }  ]}
© 2026 MonoCloud. All rights reserved.