Versions Compared

Key

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

General Information

...

ServiceAPIMethod
urac/admin/listUsersGET


Data Model: %Link to Data Model% Users

Workflow: %Link to Architecture Page%

...

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

 

Output

...

Valid Response

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

 

Invalid Response

Code Block
languagejs
titleError Response Sample
{
    "result":false,
    "errors":{
        "codes":[400406],
        "details":[
            {
                "code":400406,
                "message":"ProblemInvalid withor thetoken providedhas passwordexpired."
            }
        ]
    }
}



Error Codes


 

Code
Description
400Database Error406Invalid or token has expired.


Example (CURL)

...

Request

Code Block
languagebash
titleCalling YOUR List Users API
 > CURL -X POSTGET http://127.0.0.1:4000/...urac/admin/listUsers?tId=5551aca9e179c39b760f7a1a

Response

Code Block
languagejs
titleYOUR List Users API response
{
	"result": true,
	"data": [{
		"_id": "57063608622c47b5c097d19b"571a2a0e8cc861b98a0b9467",
		"locked": true,
		"username": "owner",
		"firstName": "owner",
		"lastName": "owner",
		"email"..."
	}: "owner@soajs.org",
		"ts": 1461332494711,
		"status": "active",
		"profile": {},
		"groups": ["owner"],
		"config": {
			"packages": {},
			"keys": {}
		},
		"tenant": {
			"id": "5551aca9e179c39b760f7a1a",
			"code": "DBTN"
		}
	}]
}