Sign in

v51

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-01131107332.8 KB
Groups

Create a new group

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 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"
  }
}