Roles:GET

GET /roles

Returns a list of available roles. Note that this will only include the roles available for users tied to a specific account; Agent-type roles (that have global access or access to an entire franchise) will not appear in this list.

Request

GET /roles

Request Parameters

None

URI Parameters

None

Request Headers

None

Response

Status Code

200 OK

Success

304 Not changed

The list of users hasn't changed since the last request; the client should use its locally cached copy instead.

401 Unauthorized

The authorization header contained an invalid value

Response Body

{
  "list": [
    "sitecontrol_account_owner",
    "sitecontrol_technical_admin",
    ...
  ],
  "links": [
    {"href": "https://api.hostway.com/roles", "rel": "self"}
  ]
}
 

Parameters

None

See Also

• Account
• GET /accounts/{accountId}/users/{userName}/roles
• PUT /accounts/{accountId}/users/{userName}/roles
• Common Features

blog comments powered by Disqus