Search
K
Cipherscale API

Update User Group

Modifies the configuration of an existing user group including its name, description, role assignments, and other settings.

put
https://public-api.cipherscale.com/qa/tenants/groups/{id}

Path Parameters

idstring(uuid)required

The unique identifier (UUID) of the group to update

Body

application/json

UpdateGroupDto

rolesarray[string]required
namestringrequired
descriptionstring

Response

application/json

GroupDto

idstring(uuid)required
createdAtstring(date-time)required
updatedAtstring(date-time)required
namestringrequired
descriptionstring
rolesarray[object]required

User role definition with specific permissions and capabilities

Show Child Parameters
deleteablebooleanrequired
usersarray[object]required
Show Child Parameters
maxDevicesnumberrequired
isSamlDefaultGroupbooleanrequired
idpMappingarray[string]required
put/tenants/groups/{id}

Body

{ "roles": [ "[]" ], "name": "name" }
 
application/json

Get Group Details

Retrieves comprehensive information about a specific user group including its members, assigned roles, permissions, and configuration settings.

get
https://public-api.cipherscale.com/qa/tenants/groups/{id}

Path Parameters

idstring(uuid)required

The unique identifier (UUID) of the group

Response

application/json

Successfully retrieved the group

GroupDto

idstring(uuid)required
createdAtstring(date-time)required
updatedAtstring(date-time)required
namestringrequired
descriptionstring
rolesarray[object]required

User role definition with specific permissions and capabilities

Show Child Parameters
deleteablebooleanrequired
usersarray[object]required
Show Child Parameters
maxDevicesnumberrequired
isSamlDefaultGroupbooleanrequired
idpMappingarray[string]required
get/tenants/groups/{id}
 
application/json

Remove User Group

Permanently removes a user group from the tenant. This operation will also remove all group members and revoke group-based permissions.

delete
https://public-api.cipherscale.com/qa/tenants/groups/{id}

Path Parameters

idstring(uuid)required

The unique identifier (UUID) of the group to delete

Response

Successfully deleted the group

delete/tenants/groups/{id}
 

Admission Rules

Access control rules and conditions

Create Admission Rule

Creates a new admission rule that defines conditions for allowing or denying access to network resources. Admission rules can include time constraints and custom logic for fine-grained access control.

post
https://public-api.cipherscale.com/qa/tenants/admission-rules

Body

application/json

The admission rule data to create

CreateAdmissionRuleDto

rulestringrequired
namestringrequired
hasTimeConstraintbooleanrequired

Response

application/json

Successfully created the admission rule

AdmissionRuleDto

idstring(uuid)required
createdAtstring(date-time)required
updatedAtstring(date-time)required
namestringrequired
typestringrequired

Allowed values:ALLOWDENYCUSTOM

hasTimeConstraintbooleanrequired
rulestring
post/tenants/admission-rules

Body

{ "rule": "rule", "name": "name", "hasTimeConstraint": false }
 
application/json