Herald
OpenapiPermission definitions

Update a permission

Update permission definition. Built-in permissions cannot be modified. Requires `permissions.manage` permission.

PUT
/api/permission/{realmId}/define/{permissionDefinitionId}

Update permission definition. Built-in permissions cannot be modified. Requires permissions.manage permission.

Authorization

bearer_auth
AuthorizationBearer <token>

In: header

Path Parameters

realmId*string

Realm ID

permissionDefinitionId*string

Permission ID

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

description?string|null
name*string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/api/permission/string/define/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "action": "string",  "description": "string",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "isBuiltin": true,  "name": "string",  "realmId": "string",  "resource": "string"}
{  "code": "string",  "details": null,  "message": "string",  "requestId": "string",  "status": 0}
{  "code": "string",  "details": null,  "message": "string",  "requestId": "string",  "status": 0}
{  "code": "string",  "details": null,  "message": "string",  "requestId": "string",  "status": 0}
{  "code": "string",  "details": null,  "message": "string",  "requestId": "string",  "status": 0}