Update a permission

Update a permission

put

Path parameters

idstringRequired

The id of the permission to update.

Header parameters

Brand-URLstringRequired

The brand URL of the request. This is used to identify the brand.

Example: YOUR_BRAND_URL

Auth-KeystringRequired

This is used to authenticate the request. If the request is not authenticated, the server will return a 401 Unauthorized response.

Example: YOUR_AUTH_KEY

Body

application/jsontext/jsonapplication/*+json

This class represents the permission data transfer object.

resourceTypeIdstring · min: 1Required

The resource type id.

codestring · min: 1Required

The permission code.

namestring · min: 1Required

The name of the permission.

descriptionstring | nullableOptional

The description of the permission.

tagsstring | nullableOptional

The tags of the permission.

Responses

200

The request was successful.

application/json

401

The user is not authorized to access the requested resource. The request is missing the required Auth-Key header.

application/json

403

The user's access was denied.

application/json

429

The user has exceeded the rate limit.

application/json

put

HTTPcURLJavaScriptPython

PUT /api/v1/permissions/{id} HTTP/1.1
Host: protocol.jframework.io
Brand-URL: text
Auth-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 142

{
  "resourceTypeId": "USER",
  "code": "USER.VIEW",
  "name": "View User",
  "description": "Allows viewing user details and profiles.",
  "tags": "#user #read"
}

application/jsontext/jsonapplication/*+json

{
  "success": true,
  "statusCode": 200,
  "message": "The request was successful.",
  "data": {
    "id": "sApKpllz4sAplsmzha",
    "parentBrandId": "sApKpllz4sAplsmzha",
    "resourceTypeId": "sApKpllz4sAplsmzha",
    "guid": "186bb221-059c-4325-8dc8-da341675be69",
    "code": "PERMISSION_CODE",
    "name": "Permission Name",
    "description": "Permission Description",
    "tags": "Permission Tags",
    "type": "Custom"
  },
  "errors": []
}