Groups

Create a new group

Changed on Oct 31, 2026

Creates a new group.

This operation can fail for the following reasons:

A server error occurred (HTTP error 500)
The group already exist (HTTP error 409)
Invalid group ID (e.g., reserved name 'default') (HTTP error 400)

post/groups

Request

The document declares no server URL.
Auth
none declared

Request body

descriptionstring

labelsLabels

User-defined name-value pairs. Name and value must be strings.

groupIdstring required

An ID of a single artifact group.

Example request

{
  "groupId": "group-identifier",
  "description": "The description of the artifact.",
  "labels": {
    "custom-1": "foo",
    "custom-2": "bar"
  }
}

Response

The group has been successfully created.

descriptionstring

ownerstring required

createdOnstring date-time required

modifiedBystring required

modifiedOnstring date-time required

labelsLabels

User-defined name-value pairs. Name and value must be strings.

groupIdstring required

An ID of a single artifact group.

Example response

{
  "groupId": "group-identifier",
  "description": "Description of the group",
  "artifactsType": "AVRO",
  "owner": "user1",
  "createdOn": "2019-03-22T12:51:19Z",
  "modifiedBy": "user2",
  "modifiedOn": "2019-07-19T15:09:00Z",
  "properties": {
    "custom-1": "foo",
    "custom-2": "bar"
  }
}

Changes

Oct 31, 2026ff9684af2aad Revision changes
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
Oct 29, 2026f17f5df4e79c Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history (13 revisions)