Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

General Information

...

ServiceAPIMethodData ModelsWorkflow
urac/admin/groupPOSTGroups

Description

This API adds a group record to the tenant that has the external key sent in the request headers.

Input

...

Type: application/json
NameSourceMandatoryTypeSpecial FormatDescription
codeBodyYESStringAlphanumeric - 20 letters MaximumGroup Code
nameBodyYESStringN/AGroup Name
descriptionBodyYESStringN/A

Group Description

environmentsBodyNOArray

Array of Strings

Group Environments
packagesBodyYESArray

Array of Objects

Group Packages


NameTypeDescription
productStringProduct Code
packagepackagesStringPackage CodeArray of StringsAn array of Package Codes 


Output

...

Response

SOAJS has a unified response. Check out this link to understand more the schema of SOAJS response 

Valid Response

Code Block
languagejs
titleValid Response Sample
linenumberstrue
collapsetrue
{ 
  result: true,
  data: { 
  code: 'FFFF',
  name: 'integration',
  description: 'integration description',
  tenant: { id: '5d9321f8b40e09438afbd0c9', code: 'test' },
  config:
   { 
     allowedEnvironments: { 
       DEV: {}, 
       TEST: {} 
     },
     allowedPackages: { 
       client: [Array] 
     } 
   },
  _id: '5d975590397e3419b784ac08' 
 }
}

Invalid Response

Code Block
languagejs
titleError Response Sample
linenumberstrue
collapsetrue
{
    "result":false,
    "errors":{
        "codes":[602],
        "details":[
            {
                "code":602,
                "message":"Model error: + %model_error%"
            }
        ]
    }
}

Response schema

Follow this link to check out the response JSON response JSON Schema

SOAJS Error Codes



Code
Description
400

Business logic required data are missing

602Model error: + %model_error%