[{"label":"Latest (v1.0)","version":"latest"}]
csp
Create Custom Group In Organization By Organization ID
DescriptionCreate a new custom group in organization.
Access Policy
| Role | User Accounts | Service Accounts (Client Credentials Applications) |
|---|---|---|
| Organization Admin | ✔️ | ✔️ |
| Organization Owner | ✔️ | ✔️ |
Request
URLURL
https://{api_host}/csp/gateway/am/api/orgs/{orgId}/groups
Path Parameters
Path Parameters
string
orgId
Required
Unique identifier (GUID) of the organization.
Parameter Serialization Style:
simple Explode:false
Request Body
Request Body
CreateCustomGroupRequest
of mimetype application/json
Required
{
"name": "string"
}
string as ^[^@]+$
name
Required
Name of the custom group to be created.
string
description
Optional
Description of the custom group to be created.
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
200 OK
Returns
IdDto
of type application/json
{
"id": "string"
}
string
id
Optional
The unique identifier of the resource.
Errors
CspErrorResponse
400
Missing required parameters or invalid parameters in request body returns a 400 (bad request) status code
CspErrorResponse
401
The user is not authorized to use the API
CspErrorResponse
403
The user is forbidden to use the API
CspErrorResponse
404
Organization with this identifier is not found.
CspErrorResponse
409
The Group with that name already exists
CspErrorResponse
429
The user has sent too many requests
CspErrorResponse
500
An unexpected error has occurred while processing the request
Code Samples
cURL Command
curl -X POST -H "Content-Type: application/json" -d '{"description":"string","name":"string"}' https://{api_host}/csp/gateway/am/api/orgs/{orgId}/groups
Vendor Extensions
This operation contains the following vendor extensions defined in the spec:
x-required-roles: org_owner,org_admin
x-slo-tier: TIER2
[{"label":"Latest (v1.0)","version":"latest"}]
csp
