Versions Compared

Key

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

General Information

...

ServiceAPIMethod
urac/admin/group/listGET


Data Model: %Link to Data Model% Groups

Workflow: %Link to Architecture Page%

...

NameSourceMandatoryTypeSpecial FormatDescription
 tIdBody or QueryYESNOStringN/A If set, the api will return the groups of a specific tenant; else the api returns all the groups in the database

 

Output

...

Valid Response

Code Block
languagejs
titleValid Response Sample
{
	"result": true,
	"data": {
		"..."	
	}
}

...

Code Block
languagejs
titleError Response Sample
{
    "result":false,
    "errors":{
        "codes":[400415],
        "details":[
            {
                "code":400415,
                "message":"ProblemUnable withto the provided passwordfind group."
            }
        ]
    }
}



Error Codes


 

Code
Description
400Database Error415Unable to find group.


Example (CURL)

...

Request

Code Block
languagebash
titleCalling YOUR List Groups API
 > CURL -X POSTGET http://127.0.0.1:4000/.../urac/admin/group/list

Response

Code Block
languagejs
titleYOUR List Groups API response
{
	"result": true,
	"data": [{
	"_id": ObjectId('5718a32f0e811ab5a0ca08b5'),
	"locked": true,
	"code": "owner",
	"name": "Owner Group",
	"description": "this is the owner group that owns the dashboard",
	"tenant": {
		"_id": "57063608622c47b5c097d19b5551aca9e179c39b760f7a1a",
		"..."code": "DBTN"
	}
},
//...]
}