Add Group

General Information

Service	API	Method
urac	/admin/group/add	POST

Data Model: Groups

Workflow: Add Group Flow

Input

Name			Source	Mandatory	Type	Special Format	Description
tId			Body or Query	YES	String	N/A	the Id of the tenant where this group is added
tCode			Body or Query	YES	String	N/A	the code of the tenant
code			Body	YES	String	N/A
name			Body	YES	String	N/A
description			Body	YES	String	N/A
config			Body	YES	Object	N/A
	allowedPackages			YES	Object	N/A
		^([A-Za-z0-9]+)$		YES	Array of strings		Then keys should follow the pattern : ^([A-Za-z0-9]+)$
	allowedEnvironments			NO	Object	N/A
		^([A-Za-z]+)$		YES	Object	N/A	for it is just an empty object

Output

Valid Response

Valid Response Sample

{
	"result": true,
	"data": true
}

Invalid Response

Error Response Sample

{
    "result":false,
    "errors":{
        "codes":[421],
        "details":[
            {
                "code":421,
                "message":"Group code already exists. Choose another"
            }
        ]
    }
}

Error Codes

Code	Description
400	Database connection error
421	Group code already exists. Choose another
611	invalid tenant id provided

Example (CURL)

Request

Calling Add Group API

 > CURL -X POST http://127.0.0.1:4000/urac/admin/group/add?tId=5551aca9e179c39b760f7a1a&tCode=DBTN -d {
	"code": "silver",
	"name": "Silver Group",
	"description": "grp description",
	"config": {
		"allowedPackages": {
			"prod": ["pack"]
		},
		"allowedEnvironments": {
			"PROD": {}
		}
	}
}

Response

Add Group API response

{
	"result": true,
	"data": true
}