This web service returns a user's tags.
Method | Endpoint |
---|---|
GET |
|
Path parameter | Type | Description |
---|---|---|
{userId} |
String | The user's identifier. See the List users or Search users web services to find a user's ID. It is also possible to get a user's ID from the Manage users menu. |
Response body
The following lines show an example of a JSON response body:
{
"id": "a43eb18a-3f48-4732-9389-61b540ce9d0d",
"manualTags": [
"tag1"
],
"authenticationTags": [
"tag2",
"tag3"
]
}
Field | Type | Description |
---|---|---|
id |
String | The user's identifier. |
manualtags |
Array | The tags that an administrator has assigned manually to the user. |
authenticationTags |
Array | The tags provided by a post-authentication script. |
Return code | Description |
---|---|
200 OK |
The request is valid and returns data. |
401 UNAUTHORIZED |
The authorization header is absent or invalid. |
403 FORBIDDEN |
The user or API key does not have the ADMIN or USERS_ADMIN role. |
404 NOT FOUND |
No user exists with this ID. |
For a comprehensive list of all possible return codes, see Return codes.