Search
K
Cipherscale API

UpdateAddress

object
protocolsarray[string](uuid)required

Array of protocol IDs (UUIDs) to associate with this address

Example:550e8400-e29b-41d4-a716-446655440000

addressstringrequired

Network address (IP address or domain name)

Example:192.168.1.100

Example
{
  "address": "192.168.1.100",
  "protocols": [
    "550e8400-e29b-41d4-a716-446655440000"
  ]
}

CreateProtocol

object

Data required to create a new network protocol definition

namestring

Human-readable name for the protocol

Example:Custom Web Services

networkProtocolsarray[object]required

Array of network protocol configurations (TCP, UDP, ICMP)

Example:{"protocol":"TCP","port":"80"}

Show Child Parameters
Example
{
  "name": "Custom Web Services",
  "networkProtocols": [
    {
      "protocol": "TCP",
      "port": "8080"
    },
    {
      "protocol": "TCP",
      "port": "8443"
    }
  ]
}

CreateGroup

object

Data required to create a new user group

rolesarray[string]required

Array of role IDs to assign to the group

Example:550e8400-e29b-41d4-a716-446655440000, 550e8400-e29b-41d4-a716-446655440001

namestringrequired

Human-readable name for the group

Example:Marketing Team

descriptionstring

Detailed description of the group’s purpose and scope

Example:Marketing team with access to customer data and analytics tools

Example
{
  "name": "Marketing Team",
  "description": "Marketing team with access to customer data and analytics tools",
  "roles": [
    "550e8400-e29b-41d4-a716-446655440000",
    "550e8400-e29b-41d4-a716-446655440001"
  ]
}

GroupUser

object

User information within a group context

idstring(uuid)required

Unique identifier for the user

Example:550e8400-e29b-41d4-a716-446655440000

createdAtstring(date-time)required

Timestamp when the user was added to the group

Example:2023-01-15T10:30:00Z

updatedAtstring(date-time)required

Timestamp when the user’s group membership was last modified

Example:2023-01-15T10:30:00Z

firstNamestringrequired

User’s first name

Example:John

lastNamestringrequired

User’s last name

Example:Doe

emailstringrequired

User’s email address

Example:john.doe@company.com

Example
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@company.com",
  "createdAt": "2023-01-15T10:30:00Z",
  "updatedAt": "2023-01-15T10:30:00Z"
}

Group

object

Complete user group information with members, roles, and configuration

idstring(uuid)required

Unique identifier for the group

Example:550e8400-e29b-41d4-a716-446655440000

createdAtstring(date-time)required

Timestamp when the group was created

Example:2023-01-15T10:30:00Z

updatedAtstring(date-time)required

Timestamp when the group was last modified

Example:2023-01-15T10:30:00Z

namestringrequired

Human-readable name for the group

Example:Engineering Team

descriptionstring

Detailed description of the group’s purpose and scope

Example:Software engineering team with access to development resources

rolesarray[object]required

User role definition with specific permissions and capabilities

Show Child Parameters
deleteablebooleanrequired

Whether this group can be deleted

Example:true

usersarray[object]required

User information within a group context

Example:{"id":"550e8400-e29b-41d4-a716-446655440000","firstName":"John","lastName":"Doe","email":"john.doe@company.com","createdAt":"2023-01-15T10:30:00Z","updatedAt":"2023-01-15T10:30:00Z"}

Show Child Parameters
maxDevicesnumberrequired

Maximum number of devices per user in this group

Example:5

isSamlDefaultGroupbooleanrequired

Whether this is the default group for SAML users

idpMappingarray[string]required

Identity provider mapping for this group

Example:engineering@company.com

Example
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Engineering Team",
  "description": "Software engineering team with access to development resources",
  "deleteable": true,
  "maxDevices": 5,
  "isSamlDefaultGroup": false,
  "idpMapping": [
    "engineering@company.com"
  ],
  "createdAt": "2023-01-15T10:30:00Z",
  "updatedAt": "2023-01-15T10:30:00Z"
}