/api/space/user-management/roles/{id}

The following operations are supported on this resource:

  • GET - Get an RBAC role
  • PUT - Update/Replace a Role
  • PATCH - Partial updates to a role
  • DELETE - Delete a role
GET /roles/{id} Version 3

Get an RBAC role.

Sample Usage

GET /roles/{id}


  • Parameters:
    Name Type URI Type Description Required
    id Integer Path ID Y
  • Sample Output XML:
    <role href="/api/space/user-management/roles/{roleId}" uri="/api/space/user-management/roles/{id}">
         <id>Integer</id>
         <name>String</name>
         <title>String</title>
         <description>String</description>
         <predefined>Boolean</predefined>
         <sharable>Boolean</sharable>
         <less-tasks>String</less-tasks>
         <capabilities uri="/api/space/user-management/roles/{id}/capabilities">
               <capability
                   href="/api/space/user-management/capabilities/{capId}" uri="/api/space/user-management/roles/{id}/capabilities/{capId}">
                   <id>Integer</id>
                   <name>String</name>
                   <title>String</title>
               </capability>
         </capabilities>
         <tasks href="/api/space/user-management/roles/{roleId}/tasks"/>
    </role>

  • Sample Output JSON:
    {
       "role" : {
         "@href" : "/api/space/user-management/roles/{roleId}" ,
         "@uri" : "/api/space/user-management/roles/{id}" ,
         "id" : "Integer" ,
         "name" : "String" ,
         "title" : "String" ,
         "description" : "String" ,
         "predefined" : "Boolean" ,
         "sharable" : "Boolean" ,
         "less-tasks" : "String" ,
         "capabilities" : {
           "@uri" : "/api/space/user-management/roles/{id}/capabilities" ,
           "capability" : {
             "@href" : "/api/space/user-management/capabilities/{capId}" ,
             "@uri" : "/api/space/user-management/roles/{id}/capabilities/{capId}" ,
             "id" : "Integer" ,
             "name" : "String" ,
             "title" : "String"
           }
         } ,
         "tasks" : {
           "@href" : "/api/space/user-management/roles/{roleId}/tasks"
         }
       }
    }

  • Access Control

    The following capabilities are required to access this API: ReadRole

      For the deprecated versions of this API, refer to :
    • version 1

    PUT /roles/{id} Version 3

    Update/Replace a Role.

    Sample Usage

    PUT /roles/{id}


    • Parameters:
      Name Type URI Type Description Required
      id Integer Path ID Y
  • Sample Input XML:
    <role>
         <title>String</title>
         <description>String</description>
         <less-tasks>String</less-tasks>
         <capabilities>
               <capability href="/api/space/user-management/capabilities/{capId}"/>
         </capabilities>
    </role>

  • Sample Output XML:
    <role href="/api/space/user-management/roles/{roleId}" uri="/api/space/user-management/roles/{id}">
         <id>Integer</id>
         <name>String</name>
         <title>String</title>
         <description>String</description>
         <predefined>Boolean</predefined>
         <sharable>Boolean</sharable>
         <less-tasks>String</less-tasks>
         <capabilities uri="/api/space/user-management/roles/{id}/capabilities">
               <capability
                   href="/api/space/user-management/capabilities/{capId}" uri="/api/space/user-management/roles/{id}/capabilities/{capId}">
                   <id>Integer</id>
                   <name>String</name>
                   <title>String</title>
               </capability>
         </capabilities>
    </role>

  • Sample Input JSON:
    {
       "role" : {
         "title" : "String" ,
         "description" : "String" ,
         "less-tasks" : "String" ,
         "capabilities" : {
           "capability" : {
             "@href" : "/api/space/user-management/capabilities/{capId}"
           }
         }
       }
    }

  • Sample Output JSON:
    {
       "role" : {
         "@href" : "/api/space/user-management/roles/{roleId}" ,
         "@uri" : "/api/space/user-management/roles/{id}" ,
         "id" : "Integer" ,
         "name" : "String" ,
         "title" : "String" ,
         "description" : "String" ,
         "predefined" : "Boolean" ,
         "sharable" : "Boolean" ,
         "less-tasks" : "String" ,
         "capabilities" : {
           "@uri" : "/api/space/user-management/roles/{id}/capabilities" ,
           "capability" : {
             "@href" : "/api/space/user-management/capabilities/{capId}" ,
             "@uri" : "/api/space/user-management/roles/{id}/capabilities/{capId}" ,
             "id" : "Integer" ,
             "name" : "String" ,
             "title" : "String"
           }
         }
       }
    }

  • Access Control

    The following capabilities are required to access this API: ModifyRole

    PATCH /roles/{id} Version 3

    Partial updates to a role.

    Sample Usage

    PATCH /roles/{id}


    • Parameters:
      Name Type URI Type Description Required
      id Integer Path ID Y
  • Sample Patch XML:
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <diff>
       <!--What you see below are just samples of patch operations that may be performed on this DTO.-->
       <!--For more information about patch document format please look at http://http://www.rfc-editor.org/rfc/rfc5261.txt-->
       <replace sel="role/title">
           <title>String</title>
       </replace>
       <replace sel="role/description">
           <description>String</description>
       </replace>
       <replace sel="role/less-tasks">
           <less-tasks>String</less-tasks>
       </replace>
       <replace sel="role/capabilities">
           <capabilities>
             <capability href="/api/space/user-management/capabilities/{capId}"/>
           </capabilities>
       </replace>
    </diff>

  • Sample Output XML:
    <role href="/api/space/user-management/roles/{roleId}" uri="/api/space/user-management/roles/{id}">
         <id>Integer</id>
         <name>String</name>
         <title>String</title>
         <description>String</description>
         <predefined>Boolean</predefined>
         <sharable>Boolean</sharable>
         <less-tasks>String</less-tasks>
         <capabilities uri="/api/space/user-management/roles/{id}/capabilities">
               <capability
                   href="/api/space/user-management/capabilities/{capId}" uri="/api/space/user-management/roles/{id}/capabilities/{capId}">
                   <id>Integer</id>
                   <name>String</name>
                   <title>String</title>
               </capability>
         </capabilities>
         <tasks href="/api/space/user-management/roles/{roleId}/tasks"/>
    </role>

  • Sample Output JSON:
    {
       "role" : {
         "@href" : "/api/space/user-management/roles/{roleId}" ,
         "@uri" : "/api/space/user-management/roles/{id}" ,
         "id" : "Integer" ,
         "name" : "String" ,
         "title" : "String" ,
         "description" : "String" ,
         "predefined" : "Boolean" ,
         "sharable" : "Boolean" ,
         "less-tasks" : "String" ,
         "capabilities" : {
           "@uri" : "/api/space/user-management/roles/{id}/capabilities" ,
           "capability" : {
             "@href" : "/api/space/user-management/capabilities/{capId}" ,
             "@uri" : "/api/space/user-management/roles/{id}/capabilities/{capId}" ,
             "id" : "Integer" ,
             "name" : "String" ,
             "title" : "String"
           }
         } ,
         "tasks" : {
           "@href" : "/api/space/user-management/roles/{roleId}/tasks"
         }
       }
    }

  • Access Control

    The following capabilities are required to access this API: ModifyRole

    DELETE /roles/{id} Version 3

    Delete a role.

    Sample Usage

    DELETE /roles/{id}


    • Parameters:
      Name Type URI Type Description Required
      id Integer Path ID Y

    Access Control

    The following capabilities are required to access this API: DeleteRole