v1

latestOpenAPI 3.0.2Apache 2.02026-07-136548173.9 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
propertiesProperties

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

idstring required

Example request

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

Response

The group has been successfully created.

idstring required

An ID of a single artifact group.

descriptionstring required
createdBystring required
createdOnstring date-time required
modifiedBystring required
modifiedOnstring date-time required
propertiesProperties required

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

Example response

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