Delete group

Delete a group by its ID. Groups synced from an IdP cannot be deleted through this API.

DEL

/v1/groups/{id}

DEL

/groups/{id}

curl -X DELETE "https://api.corma.io/v1/groups/-9007199254740991" \
  -H "x-corma-api-key: $CORMA_OPEN_API_KEY"

Authorization

x-corma-api-key
string
header
required
Colon-separated API key ID and secret: API_KEY_ID:API_KEY_SECRET

Parameters

id
integer
path
required
x-corma-idempotency-key
string
header
Optional client-generated key. Reusing the same key with an identical request replays the original response instead of enqueueing a duplicate task.

Response

application/json200

OK

id
number
required
name
string
required
kind
enum<string>
required
One of:
manual
dynamic
idp
memberCount
number
required
createdAt
string<date-time>
required
The timestamp of when this resource was created. ISO 8601 format.
updatedAt
string<date-time>
required
The timestamp of the last update to this resource. ISO 8601 format.

{
  "id": 0,
  "name": "string",
  "kind": "manual",
  "memberCount": 0,
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z"
}

DEL

/groups/{id}

curl -X DELETE "https://api.corma.io/v1/groups/-9007199254740991" \
  -H "x-corma-api-key: $CORMA_OPEN_API_KEY"

{
  "id": 0,
  "name": "string",
  "kind": "manual",
  "memberCount": 0,
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z"
}

API referenceGroups

Delete group

Delete a group by its ID. Groups synced from an IdP cannot be deleted through this API.

DEL

/v1/groups/{id}

DEL

/groups/{id}

curl -X DELETE "https://api.corma.io/v1/groups/-9007199254740991" \
  -H "x-corma-api-key: $CORMA_OPEN_API_KEY"

Authorization

x-corma-api-key
string
header
required
Colon-separated API key ID and secret: API_KEY_ID:API_KEY_SECRET

Parameters

id
integer
path
required
x-corma-idempotency-key
string
header
Optional client-generated key. Reusing the same key with an identical request replays the original response instead of enqueueing a duplicate task.

Response

application/json200

OK

id
number
required
name
string
required
kind
enum<string>
required
One of:
manual
dynamic
idp
memberCount
number
required
createdAt
string<date-time>
required
The timestamp of when this resource was created. ISO 8601 format.
updatedAt
string<date-time>
required
The timestamp of the last update to this resource. ISO 8601 format.

{
  "id": 0,
  "name": "string",
  "kind": "manual",
  "memberCount": 0,
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z"
}

DEL

/groups/{id}

curl -X DELETE "https://api.corma.io/v1/groups/-9007199254740991" \
  -H "x-corma-api-key: $CORMA_OPEN_API_KEY"

{
  "id": 0,
  "name": "string",
  "kind": "manual",
  "memberCount": 0,
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z"
}