OAA Admin API

Updates the group

put

/oaa-policy/group/v1/{groupid}

Updates Group API

Request

Path Parameters

groupid(required): string

Unique global identifier of the group

Supported Media Types

application/xml
application/json

Root Schema : schema

Type: object

Request object to update group structure

Show Source

addvalues: array addvalues

Values to be added to the group. It can be of type long, string, integer. For IP range it needs to be long.
description: string

Description of the group to be updated.
groupname: string

Unique name of the group in the system.
removevalues: array removevalues

Values to be removed from the group. Values which are not present will be ignored.

{
    "type":"object",
    "description":"Request object to update group structure",
    "properties":{
        "groupname":{
            "type":"string",
            "description":"Unique name of the group in the system."
        },
        "description":{
            "type":"string",
            "description":"Description of the group to be updated."
        },
        "addvalues":{
            "type":"array",
            "items":{
                "type":"object"
            },
            "description":"Values to be added to the group. It can be of type long, string, integer. For IP range it needs to be long."
        },
        "removevalues":{
            "type":"array",
            "items":{
                "type":"object"
            },
            "description":"Values to be removed from the group. Values which are not present will be ignored."
        }
    }
}

Nested Schema : addvalues

Type: array

Values to be added to the group. It can be of type long, string, integer. For IP range it needs to be long.

Show Source

Array of: object items

{
    "type":"array",
    "items":{
        "type":"object"
    },
    "description":"Values to be added to the group. It can be of type long, string, integer. For IP range it needs to be long."
}

Nested Schema : removevalues

Type: array

Values to be removed from the group. Values which are not present will be ignored.

Show Source

Array of: object items

{
    "type":"array",
    "items":{
        "type":"object"
    },
    "description":"Values to be removed from the group. Values which are not present will be ignored."
}

Nested Schema : items

Type: object

Nested Schema : items

Type: object

Root Schema : schema

Type: object

Request object to update group structure

Show Source

addvalues: array addvalues

Values to be added to the group. It can be of type long, string, integer. For IP range it needs to be long.
description: string

Description of the group to be updated.
groupname: string

Unique name of the group in the system.
removevalues: array removevalues

Values to be removed from the group. Values which are not present will be ignored.

{
    "type":"object",
    "description":"Request object to update group structure",
    "properties":{
        "groupname":{
            "type":"string",
            "description":"Unique name of the group in the system."
        },
        "description":{
            "type":"string",
            "description":"Description of the group to be updated."
        },
        "addvalues":{
            "type":"array",
            "items":{
                "type":"object"
            },
            "description":"Values to be added to the group. It can be of type long, string, integer. For IP range it needs to be long."
        },
        "removevalues":{
            "type":"array",
            "items":{
                "type":"object"
            },
            "description":"Values to be removed from the group. Values which are not present will be ignored."
        }
    }
}

Nested Schema : addvalues

Type: array

Values to be added to the group. It can be of type long, string, integer. For IP range it needs to be long.

Show Source

Array of: object items

{
    "type":"array",
    "items":{
        "type":"object"
    },
    "description":"Values to be added to the group. It can be of type long, string, integer. For IP range it needs to be long."
}

Nested Schema : removevalues

Type: array

Values to be removed from the group. Values which are not present will be ignored.

Show Source

Array of: object items

{
    "type":"array",
    "items":{
        "type":"object"
    },
    "description":"Values to be removed from the group. Values which are not present will be ignored."
}

Nested Schema : items

Type: object

Nested Schema : items

Type: object

Response

Supported Media Types

application/xml
application/json

200 Response

Group is updated

Root Schema : GroupResponse

Type: object

Group response object

Show Source

group: object schema

Defines a new group structure
groupid: string

Unique key of the group.
message: string

Message related to the status of the request
status: string

Status of the request

{
    "type":"object",
    "description":"Group response object",
    "required":[
        "key",
        "name",
        "agentgid"
    ],
    "properties":{
        "status":{
            "type":"string",
            "description":"Status of the request"
        },
        "message":{
            "type":"string",
            "description":"Message related to the status of the request"
        },
        "groupid":{
            "type":"string",
            "description":"Unique key of the group."
        },
        "group":{
            "$ref":"#/components/schemas/Group"
        }
    }
}

Nested Schema : schema

Type: object

Defines a new group structure

Show Source

agentid: string

Identifier of the agent which owns the group.
description: string

Description of the group.
groupid(required): string

Unique identifier of group.
groupname(required): string

Unique name of the group in the system.
grouptype(required): string

Type of the group. Can be one of the User ID, Generic Strings, Actions, IP Ranges and IPs
values: array values

Values of elements in the group. Values depend on type of group.

{
    "type":"object",
    "description":"Defines a new group structure",
    "required":[
        "groupid",
        "groupname",
        "grouptype"
    ],
    "properties":{
        "groupid":{
            "type":"string",
            "description":"Unique identifier of group."
        },
        "agentid":{
            "type":"string",
            "description":"Identifier of the agent which owns the group."
        },
        "grouptype":{
            "type":"string",
            "description":"Type of the group. Can be one of the User ID, Generic Strings, Actions, IP Ranges and IPs"
        },
        "groupname":{
            "type":"string",
            "description":"Unique name of the group in the system."
        },
        "description":{
            "type":"string",
            "description":"Description of the group."
        },
        "values":{
            "type":"array",
            "items":{
                "type":"object"
            },
            "description":"Values of elements in the group. Values depend on type of group."
        }
    }
}

Nested Schema : values

Type: array

Values of elements in the group. Values depend on type of group.

Show Source

Array of: object items

{
    "type":"array",
    "items":{
        "type":"object"
    },
    "description":"Values of elements in the group. Values depend on type of group."
}

Nested Schema : items

Type: object

401 Response

Unauthorized

405 Response

Invalid input

Root Schema : GroupResponse

Type: object

Group response object

Show Source

group: object schema

Defines a new group structure
groupid: string

Unique key of the group.
message: string

Message related to the status of the request
status: string

Status of the request

{
    "type":"object",
    "description":"Group response object",
    "required":[
        "key",
        "name",
        "agentgid"
    ],
    "properties":{
        "status":{
            "type":"string",
            "description":"Status of the request"
        },
        "message":{
            "type":"string",
            "description":"Message related to the status of the request"
        },
        "groupid":{
            "type":"string",
            "description":"Unique key of the group."
        },
        "group":{
            "$ref":"#/components/schemas/Group"
        }
    }
}

Nested Schema : schema

Type: object

Defines a new group structure

Show Source

agentid: string

Identifier of the agent which owns the group.
description: string

Description of the group.
groupid(required): string

Unique identifier of group.
groupname(required): string

Unique name of the group in the system.
grouptype(required): string

Type of the group. Can be one of the User ID, Generic Strings, Actions, IP Ranges and IPs
values: array values

Values of elements in the group. Values depend on type of group.

{
    "type":"object",
    "description":"Defines a new group structure",
    "required":[
        "groupid",
        "groupname",
        "grouptype"
    ],
    "properties":{
        "groupid":{
            "type":"string",
            "description":"Unique identifier of group."
        },
        "agentid":{
            "type":"string",
            "description":"Identifier of the agent which owns the group."
        },
        "grouptype":{
            "type":"string",
            "description":"Type of the group. Can be one of the User ID, Generic Strings, Actions, IP Ranges and IPs"
        },
        "groupname":{
            "type":"string",
            "description":"Unique name of the group in the system."
        },
        "description":{
            "type":"string",
            "description":"Description of the group."
        },
        "values":{
            "type":"array",
            "items":{
                "type":"object"
            },
            "description":"Values of elements in the group. Values depend on type of group."
        }
    }
}

Nested Schema : values

Type: array

Values of elements in the group. Values depend on type of group.

Show Source

Array of: object items

{
    "type":"array",
    "items":{
        "type":"object"
    },
    "description":"Values of elements in the group. Values depend on type of group."
}

Nested Schema : items

Type: object

500 Response

Internal server error

503 Response

Service Unavailable

Examples

The following example shows a sample request and response for updating the group.

cURL Command to Update a Group in JSON Format

curl --location --request PUT '<PolicyUrl>/oaa-policy/group/v1/111_4141dd92a40fa2ff8d09153e62c658c67f3c7ac014ce89c0c103896230457718' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic <Base64Encoded(<username>:<password>)>' \
--data '{
    "groupname": "FactorRuleGrp1",
    "description": "Group to set factors",
    "addvalues": [
        "ChallengeOMATOTP",
        "ChallengeYubicoOTP"
    ],
    "removevalues": [
        "ChallengeSMS"
    ]
}'

Sample Response in JSON Format

{
    "status": "200",
    "message": "Group updated",
    "groupid": "111_4141dd92a40fa2ff8d09153e62c658c67f3c7ac014ce89c0c103896230457718",
    "group": {
        "groupid": "111_4141dd92a40fa2ff8d09153e62c658c67f3c7ac014ce89c0c103896230457718",
        "agentid": "dede64d3-1d6a-42e9-89e1-714e88f8967c",
        "grouptype": "Actions",
        "groupname": "FactorRuleGrp1",
        "description": "Group to set factors",
        "values": [
            "ChallengeEmail",
            "ChallengeOMATOTP",
            "ChallengeYubicoOTP"
        ]
    }
}

cURL Command to Update a Group in XML Format

curl --location --request PUT '<PolicyUrl>/oaa-policy/group/v1/111_4141dd92a40fa2ff8d09153e62c658c67f3c7ac014ce89c0c103896230457718' \
--header 'Content-Type: application/xml' \
--header 'Accept: application/xml' \
--header 'Authorization: Basic <Base64Encoded(<username>:<password>)>' \
--data '<?xml version="1.0" encoding="UTF-8" ?>
 <UpdateGroupRequest>
     <groupname>FactorRuleGrp1</groupname>
     <description>Group to set factors</description>
     <addvalues>ChallengeOMATOTP</addvalues>
     <addvalues>ChallengeYubicoOTP</addvalues>
     <removevalues>ChallengeSMS</removevalues>
 </UpdateGroupRequest>
'

Sample Response in XML Format

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <GroupResponse>
     <status>200</status>
     <message>Group updated</message>
     <groupid>111_4141dd92a40fa2ff8d09153e62c658c67f3c7ac014ce89c0c103896230457718</groupid>
     <group>
         <groupid>111_4141dd92a40fa2ff8d09153e62c658c67f3c7ac014ce89c0c103896230457718</groupid>
         <agentid>dede64d3-1d6a-42e9-89e1-714e88f8967c</agentid>
         <grouptype>Actions</grouptype>
         <groupname>FactorRuleGrp1</groupname>
         <description>Group to set factors</description>
         <values>ChallengeEmail</values>
         <values>ChallengeOMATOTP</values>
         <values>ChallengeYubicoOTP</values>
     </group>
 </GroupResponse>