1. Development Integration
  2. /
  3. SDK
  4. /
  5. Java
  6. /

  7. Management module

  8. /

  9. Manage data resources and permissions

  10. /
  11. Modify Permission Space

Modify the permission space

Update time: 2025-07-23 07:34:21
Edit

This document is automatically generated based on https://github.com/authing/authing-docs-factory based on the https://api-explorer.genauth.ai V3 API, and is consistent with the API parameters and return results. If the document description is incorrect, please refer to the V3 API.

Modify the permission space, you can modify the permission space Name, permission space description information and the new unique identifier (Code) of the permission space.

Method Name

ManagementClient.updatePermissionNamespace

Request Parameters

NameType
Is it required
Default Value
Description
Example Value
codestringyes-Permission group old unique identifier CodeexamplePermissionNamespace
namestringno-Permission space NameExample Permission Space
newCodestringno-Permission group new unique identifier CodeexampleNewPermissionNamespace
descriptionstringno-Permission space descriptionExample Permission Space Description

Sample Code

package test.management;

import cn.authing.sdk.java.client.ManagementClient;
import cn.authing.sdk.java.dto.UpdatePermissionNamespaceDto;
import cn.authing.sdk.java.dto.UpdatePermissionNamespaceResponseDto;
import cn.authing.sdk.java.model.ManagementClientOptions;
import cn.authing.sdk.java.util.JsonUtils;


public class UpdatePermissionNamespaceTest {
    // Need to be replaced with your GenAuth Access Key ID
    private static final String ACCESS_KEY_ID = "AUTHING_ACCESS_KEY_ID";
    // Need to be replaced with your GenAuth Access Key Secret
    private static final String ACCESS_KEY_SECRET = "AUTHING_ACCESS_KEY_SECRET";

    public static void main(String[] args) throws Throwable {
        ManagementClientOptions clientOptions = new ManagementClientOptions();
        clientOptions.setAccessKeyId(ACCESS_KEY_ID);
        clientOptions.setAccessKeySecret(ACCESS_KEY_SECRET);
        // If you are a private deployment customer, you need to set the GenAuth service domain name
        // clientOptions.setHost("https://api.your-authing-service.com");
        ManagementClient client = new ManagementClient(clientOptions);

        UpdatePermissionNamespaceDto request = new UpdatePermissionNamespaceDto();
        request.setCode("examplePermissionNamespace");
        request.setName("example new permission space Name");
        request.setNewCode("exampleNewPermissionNamespace");
        request.setDescription("example new permission space description");

        UpdatePermissionNamespaceResponseDto response = client.updatePermissionNamespace(request);
        System.out.println(JsonUtils.serialize(response));
    }

}

Request Response

Type： UpdatePermissionNamespaceResponseDto

NameTypeDescription
statusCodenumberBusiness status code. You can use this status code to determine whether the operation is successful. 200 means success.
messagestringDescription
apiCodenumberSegment error code, through which the specific error type can be obtained (not returned for successful requests). For a detailed list of error codes, see：API Code List (opens new window)
requestIdstringRequest ID. Returned when the request fails.
dataUpdatePermissionNamespaceRespDtoResponse data

Example Results：

{
  "statusCode": 200,
  "message": "Operation successful",
  "requestId": "934108e5-9fbf-4d24-8da1-c330328abd6c",
  "data": {
    "code": "examplePermissionNamespace",
    "name": "Example Permission Space",
    "description": "Example Permission Space Description"
  }
}

Data Structure

UpdatePermissionNamespaceRespDto

NameType
Is it required
Description
Example Value
codestringyespermission space unique identifierexamplePermissionNamespace
namestringyespermission space Nameexample permission space
descriptionstringnopermission space descriptionexample permission space description