Users Endpoints (2017/01)
Â
These endpoints enable management of users on a network. A user is an instance of a person that is associated with a single network (there can only be one person, but there can be 0 to an infinite number of users on a network).
Base URL for these endpoints:Â Â https://api.brightsignnetwork.com/2017/01/REST/Users
GETÂ /
Returns a list of user instances on a network
Parameters
marker
 string
A value specifying which page to retrieve. This value is useful if the isTruncated
 entry in the response body of the previous GET call indicates that the number of user instances exceeds the pageSize
.
pageSize
int
The maximum number of user instances that can be contained in the response body
______________________________________________________________
Response Body
Returns a paged list of User Entity instances on a network. This will return not more than 100 entities along with the information necessary to return any other remaining pages.
Â
POSTÂ /
Creates a user instance on a network
Request Body
The User Entity
______________________________________________________________
Response Body
Returns a 201 status code and the new resource created and referenced by the Uri (given by the Location header field) in the response. The response includes the User Entity.
Â
GETÂ /{login}/Â
Returns information for a specified user on a network
Parameters
login
string
The login information of the user
______________________________________________________________
Response Body
Returns the User Entity
Â
PUTÂ /{login}/Â
Updates information for a specified user on a network
Parameters
login
string
The login information of the user
______________________________________________________________
Request Body
The User Entity
______________________________________________________________
Response Body
On success this method returns a status code 2XX, on failure it returns a status code of 5XX.
Â
DELETEÂ /{login}/Â
Deletes information for a specified user on a network
Parameters
login
string
The login information of the user
______________________________________________________________
Response Body
On success this method returns a status code 2XX, on failure it returns a status code of 5XX.
Â
GETÂ /{id:int}/Â
Returns information for a specified user on a network.
Parameters
id
int
A unique identifier for a user
______________________________________________________________
Response Body
Returns the User Entity
Â
PUTÂ /{id:int}/Â
Update the given user instance
Parameters
id
int
A unique identifier for a user
______________________________________________________________
Request Body
The User Entity
______________________________________________________________
Response Body
On success this method returns a status code 2XX, on failure it returns a status code of 5XX.
Â
DELETEÂ /{id:int}/Â
Deletes information for a specified user on a network
Parameters
id
int
A unique identifier for a user
______________________________________________________________
Response Body
On success this method returns a status code 2XX, on failure it returns a status code of 5XX
Â
GETÂ /Operations/Â
Returns the operational permissions granted to roles for specific business operations
Response Body
Returns the Business Operations Entity
Â
GETÂ /{id:int}/Permissions/Â
Includes object permissions for a given user instance.
Parameters
id
int
A unique identifier for a user
______________________________________________________________
Response Body
Returns the Permission Entity
Â
POSTÂ /{id:int}/Permissions/Â
Adds permissions for a specified user on a network
Parameters
id
int
A unique identifier for a user
______________________________________________________________
Request Body
The Permission Entity
______________________________________________________________
Response Body
On success this method returns a status code 2XX, on failure it returns a status code of 5XX.
Â
DELETEÂ /{id:int}/Permissions/Â
Removes permissions for a specified user on a network
Parameters
id
int
A unique identifier for a user
______________________________________________________________
Request Body
The Permission Entity
______________________________________________________________
Response Body
On success this method returns a status code 2XX, on failure it returns a status code of 5XX.
Â
GETÂ /{login}/Permissions/Â
Includes object permissions for a given user instance.
Parameter
login
string
The login information of the user
______________________________________________________________
Response Body
Returns the Permission Entity
Â
POSTÂ /{login}/Permissions/Â
Adds permissions for a specified user on a network
Parameter
login
string
The login information of the user
______________________________________________________________
Request Body
The Permission Entity
______________________________________________________________
Response Body
On success this method returns a status code 2XX, on failure it returns a status code of 5XX.
Â
DELETEÂ /{login}/Permissions/Â
Removes permissions for a specified user on a network
Parameter
login
string
The login information of the user
______________________________________________________________
Request Body
The Permission Entity
______________________________________________________________
Response Body
On success this method returns a status code 2XX, on failure it returns a status code of 5XX.