Create a group

POST 
/api/web/v1/groups

Create a group with the specified name. Caller requires the GROUPS:ADD permission.

Request

application/json

Body

required

externalId string

The optional externalId of this group. Specify an empty string to remove the existing value of the externalId.

name string

The name of this group. This value is required when creating a group.

Responses

200

Successful

application/json

Schema

Schema

created date-time

When the group was created.

externalId string

The externalId of this group.

id string

The UUID of this group. This value is generated when the group is created.

lastModified date-time

When the group was last modified.

name stringrequired

The name of this group.

type string

Possible values: [LDAP_AD, MGMT_UI]

The type of group indicating if this group was synchronized from a directory (LDAP_AD) or was created in Identity as a Service (MGMT_UI).

Example (from schema)

{
  "created": "2019-02-19T13:15:27Z",
  "externalId": "string",
  "id": "string",
  "lastModified": "2019-02-19T13:15:27Z",
  "name": "string",
  "type": "MGMT_UI"
}

400

Bad Request

application/json

Schema

Schema

errorCode string

Error Codes specific to cause of failure.

errorMessage string

Additional Error Message describing the error.

parameters object[]

Optional additional error information.

Example (from schema)

{
  "errorCode": "invalid_user_response",
  "errorMessage": "Application id cannot be null",
  "parameters": [
    {}
  ]
}

401

Access denied

application/json

Schema

Schema

errorCode string

Error Codes specific to cause of failure.

errorMessage string

Additional Error Message describing the error.

parameters object[]

Optional additional error information.

Example (from schema)

{
  "errorCode": "invalid_user_response",
  "errorMessage": "Application id cannot be null",
  "parameters": [
    {}
  ]
}

403

Forbidden

application/json

Schema

Schema

errorCode string

Error Codes specific to cause of failure.

errorMessage string

Additional Error Message describing the error.

parameters object[]

Optional additional error information.

Example (from schema)

{
  "errorCode": "invalid_user_response",
  "errorMessage": "Application id cannot be null",
  "parameters": [
    {}
  ]
}

404

Not Found

application/json

Schema

Schema

errorCode string

Error Codes specific to cause of failure.

errorMessage string

Additional Error Message describing the error.

parameters object[]

Optional additional error information.

Example (from schema)

{
  "errorCode": "invalid_user_response",
  "errorMessage": "Application id cannot be null",
  "parameters": [
    {}
  ]
}

409

Conflict

application/json

Schema

Schema

errorCode string

Error Codes specific to cause of failure.

errorMessage string

Additional Error Message describing the error.

parameters object[]

Optional additional error information.

Example (from schema)

{
  "errorCode": "invalid_user_response",
  "errorMessage": "Application id cannot be null",
  "parameters": [
    {}
  ]
}

Loading...