The GET method with a user ID (username) retrieves a single descriptor containing the full list of user properties and roles.
• | In the community edition of the server, or commercial editions without organizations, use the first form of the URL. |
• | In commercial editions with organizations, use the second URL to specify the user’s organization. When specifying the organization, use its unique ID, not its path. When logged in as the system admin (superuser), use the first URL to specify users of the root organization. |
Method | URL | ||
GET | http://<host>:<port>/jasperserver[-pro]/rest_v2/users/userID http://<host>:<port>/jasperserver[-pro]/rest_v2/organizations/orgID/users/userID | ||
Options | |||
accept: application/xml (default) accept: application/json | |||
Return Value on Success | Typical Return Values on Failure | ||
200 OK – The content is the descriptor for the given user. | 404 Not Found – When the user ID or organization ID does not match any user or organization. The content includes an error message. |
The full user descriptor includes detailed information about the user account, including any roles. The following example shows the descriptor in XML format:
GET http://localhost:8080/jasperserver/rest_v2/users/joeuser
In servers with multiple organizations, the full descriptor includes the organization (tenant) ID. The following example shows the descriptor in JSON format:
GET http://localhost:8080/jasperserver/rest_v2/organizations/Finance/users/joeuser
Recommended Comments
There are no comments to display.