Skip to content

Create an empty Group; membership is a separate explicit authority change.

POST
/api/v1/admin/groups
curl --request POST \
--url https://example.com/api/v1/admin/groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "name": "example" }'

Route: /api/v1/admin/groups. Inputs: . A recent account assertion is required. Do not automatically replay this operation after an uncertain result.

Media typeapplication/json

Names are bounded and trimmed; control characters have no UI meaning (#1028).

object
name
required
string
Examplegenerated
{
"name": "example"
}
Media typeapplication/json

Stable Group identity and its current plain name, available to share owners.

object
id
required
string format: uuid
name
required
string
Examplegenerated
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"name": "example"
}