POST [/instances/$INSTANCE]/private/groups

This is used to create a group.

Required permission: groups-write

Request:

The request must be a GroupAddRequest.

Response:

200 OK:

The backend has successfully added a new group. Returns a GroupAddedResponse.

404 Not found:

The merchant instance is unknown.

409 Conflict:

A group with this name already exists. Returned with TALER_EC_MERCHANT_PRIVATE_PRODUCT_GROUP_CONFLICTING_NAME.

413 Request entity too large:

The uploaded body is to long, it exceeds the size limit. Returned with an error code of TALER_EC_GENERIC_UPLOAD_EXCEEDS_LIMIT.

500 Internal Server Error:

The server experienced an internal failure. Returned with TALER_EC_GENERIC_DB_STORE_FAILED.

Details:

interface GroupAddRequest {

  // Unique name for the group (unique per instance).
  group_name: string;

  // Description of the group.
  description: string;

}

interface GroupAddedResponse {

  // Unique ID for the group.
  group_serial_id: Integer;

}