CreateGroup

POST

https://orgs.ezghcloud.com/v1/organizations/{orgId}/groups

View as Markdown

Authorization

apiKeyoptionalHTTP
sessionCookieoptionalAPI key in cookie
oauthoptionalHTTP

Path parameters

orgIdstringrequired

Header parameters

idempotency-keyoptionalstring

Request bodyJSONrequired

namestringrequired
descriptionoptionalstring

Returns

201

Success

JSON

idstringrequired
namestringrequired
slugstringrequired
resourceNamestringrequired
descriptionstringrequired
membersarray ofobjectrequired
2 properties
- typeuserorbotrequired
- idstringrequired
policyIdsarray ofstringrequired
managedBystringornullrequired
2 variants
One of the following:
string
null
lockedbooleanrequired
createdAtstringrequired
updatedAtstringrequired

400

InvalidRequest

JSON

errorobjectrequired
3 properties
- codeinvalid_requestrequired
- messagestringrequired
- issuesoptionalarray ofobject
  2 properties
  pathstringrequired
  messagestringrequired

401

Unauthenticated

JSON

errorobjectrequired
2 properties
- codeunauthenticatedrequired
- messagestringrequired

403

AccessDenied | ForbiddenOrigin

JSON

One of the following:

AccessDeniedEncoded
View AccessDeniedEncoded schema →
1 properties
- errorobjectrequired
  2 properties
  codeaccess_deniedrequired
  messagestringrequired
ForbiddenOriginEncoded
View ForbiddenOriginEncoded schema →
1 properties
- errorobjectrequired
  2 properties
  codeforbidden_originrequired
  messagestringrequired

404

NotFound

JSON

errorobjectrequired
2 properties
- codenot_foundrequired
- messagestringrequired

409

IdempotencyConflict | IdempotencyInProgress

JSON

One of the following:

IdempotencyConflictEncoded
View IdempotencyConflictEncoded schema →
1 properties
- errorobjectrequired
  2 properties
  codeidempotency_conflictrequired
  messagestringrequired
IdempotencyInProgressEncoded
View IdempotencyInProgressEncoded schema →
1 properties
- errorobjectrequired
  2 properties
  codeidempotency_in_progressrequired
  messagestringrequired

429

TooManyRequests

JSON

errorobjectrequired
2 properties
- codetoo_many_requestsrequired
- messagestringrequired

500

InternalError

JSON

errorobjectrequired
2 properties
- codeinternal_errorrequired
- messagestringrequired

503

Unavailable

JSON

errorobjectrequired
2 properties
- codeunavailablerequired
- messagestringrequired

curl --request POST \ --url https://orgs.ezghcloud.com/v1/organizations/string/groups \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "name": "string", "description": "string" } '

{ "id": "string", "name": "string", "slug": "string", "resourceName": "string", "description": "string", "members": [ { "type": "user", "id": "string" } ], "policyIds": [ "string" ], "managedBy": "scim", "locked": true, "createdAt": "string", "updatedAt": "string" }