...
...
...
...
...
...
...
...
General Information
...
| Service | API | Method | Data Models | Workflow |
|---|---|---|---|---|
| urac | /admin/group/add | POST |
...
...
Description
This API adds a group record to the tenant that has the external key sent in the request headers.
Input
...
Type: application/json
| Name | Source | Mandatory | Type | Special Format | Description |
|---|---|---|---|---|---|
| code | Body | YES | String | Alphanumeric |
| - 20 letters Maximum | Group Code | ||||
| name | Body | YES | String | N/A | Group Name |
| description | Body | YES | String | N/A | Group Description |
| environments | Body |
| NO |
Then keys should follow the pattern :
^([A-Za-z0-9]+)$
...
| Array | Array of Strings | Group Environments | ||||||||||||
| packages | Body | YES | Array | Array of Objects | Group Packages | |||||||||
| ||||||||||||||
Output
...
Response
SOAJS has a unified response. Check out this link to understand more the schema of SOAJS response
Valid Response
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{ "
result": true,
"data": true } |
Invalid Response
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"result":falsecode: 'FFFF',
"errors"name:{ 'integration',
description: 'integration description',
"codes":[421],
"details":[tenant: { id: '5d9321f8b40e09438afbd0c9', code: 'test' },
config:
{
allowedEnvironments: {
DEV: {},
"code":421, TEST: {}
},
"message"allowedPackages:"Group code{ already
exists. Choose another" client: [Array]
}
},
]
_id: '5d975590397e3419b784ac08'
}
} |
...
Code
...
Description
...
Request
| Code Block | ||||
|---|---|---|---|---|
| ||||
> CURL -X POST http://127.0.0.1:4000/urac/admin/group/add -d {
"code": "silver",
"name": "Silver Group",
"description": "grp description",
"config": {
"allowedPackages": {
"prod": ["pack"]
},
"allowedEnvironments": {
"PROD": {}
}
}
} |
Response
...
| language | js |
|---|---|
| title | Add Group API response |
...
Invalid Response
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"result":false,
"errors":{
"codes":[602],
"details":[
{
"code":602,
"message":"Model error: + %model_error%"
}
]
}
} |
Code | Description |
|---|---|
| 400 | Business logic required data are missing |
| 602 | Model error: + %model_error% |