PUT /Self/
Updates the requestor’s information (your profile).
Any customer can edit their own password, first name, and last name regardless of network membership, but cannot edit someone else's name or password.
The login property, whose values are email addresses, is a key and not editable. To give another customer access to that property or handle an email address change, a user with sufficient privileges need to create a new person, add it to the same network, assign them to the same role, and copy the custom user permissions (if any) from an existing user. This can be done in the Users Endpoints (2022/06)#POST API call.
Required Scope
bsn.api.self.info.update
______________________________________________________________
Request Body
The Person Entity
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
PUT /2022/06/REST/Self/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
Content-Type: application/json
Content-Length: 280
This is the example request body:
{
"id": 0,
"login": "JaneDoe@brightsign.biz",
"password": null,
"firstName": "Jane",
"lastName": "Doe",
"creationDate": "0001-01-01T00:00:00",
"lastModifiedDate": "0001-01-01T00:00:00",
"activationDate": "0001-01-01T00:00:00"
}
______________________________________________________________
Response
Success
204: The specified person has been updated
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
412: Precondition failed (the resource/person changed since the time specified in the “If-Unmodified-Since” header value)
415: The server cannot accept the data representation that you sent (as specified in the "Content-Type" header)
5XX: Any 500 code is an internal server error
GET /{login}/Password/
Initiate a password reset for a person
Required Scope
None
______________________________________________________________
Segment
login string
The person's login in the form of an email address
returnURL string optional
A callback URL that the authentication server will return to the user in case of a successful password reset
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
loginis set tosmulqueen@brightsign.bizreturnURLis set tohttps://bsn.cloud/
GET /2022/06/REST/smulqueen%40brightsign.biz/Password?returnUrl=https%3A%2F%2Fbsn.cloud%2F HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Accept-Encoding: gzip,deflate
Authorization: {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error
______________________________________________________________
Response
Success Response Body
202: On success, this method triggers an email to your login which contains a reference to a password reset page and a return URL as a callback
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
GET /Self/Tokens/{token}/
Gets the status of the specified OAuth2 person access or refresh token
Required Scope Token
bsn.api.self.token.validate
______________________________________________________________
Segment
token string
A person access or refresh token
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
tokenis set toBearer {{UserAccessToken}}
GET /2022/06/REST/Self/Tokens/Bearer {{UserAccessToken}}/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response Body
200: Returns the Token Info Entity
Example
{
"token": Bearer {{UserAccessToken}},
"scope": "add_device_setup bsn.api.main bsn.api.self bsn.api.upload bsn.ui.main player",
"validFrom": "2023-11-29T17:43:55Z",
"validTo": "2023-11-29T17:58:55Z"
}
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The specified person or access refresh token is expired, revoked, or invalid.
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
DELETE /Self/Tokens/{token}/
Revokes a person access or refresh token
Required Scope Token
bsn.api.self.token.revoke
______________________________________________________________
Segment
token string
A person access or refresh token
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
tokenis set toBearer {{UserAccessToken}}
DELETE /2022/06/REST/Self/Tokens/Bearer {{UserAccessToken}}/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success
204: The person access or refresh token has been deleted
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The specified person or access refresh token is expired, revoked, or invalid.
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
GET /Self/Networks/
Returns the networks associated with a person
Required Scope Token
bsn.api.self.networks.retrieve
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
GET /2022/06/REST/Self/Networks/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response Body
200: Returns an array of Network Entity instances in which the current person is a member
Example
[
{
"id": 5825,
"name": "ControlCloud_Network1",
"creationDate": "2020-07-14T18:40:58.087Z",
"lastModifiedDate": "2020-07-14T18:40:58.087Z",
"lockoutDate": null,
"isLockedOut": false,
"lastLockoutDate": null,
"settings": {
"userAccessTokenLifetime": "00:15:00",
"userRefreshTokenLifetime": "1.00:00:00",
"deviceAccessTokenLifetime": "00:15:00",
"deviceRefreshTokenLifetime": "730.00:00:00",
"deviceRegistrationTokenLifetime": "730.00:00:00",
"automaticTaggedPlaylistApprovalEnabled": false,
"lastModifiedDate": "2020-07-14T18:41:00.613Z"
},
"subscription": {
"id": 12246,
"level": "Control",
"creationDate": "2020-07-14T18:40:58.783Z",
"lastModifiedDate": "2020-07-14T18:40:58.783Z",
"expireDate": null
}
},
{
"id": 30977,
"name": "ContentCloud_Network2",
"creationDate": "2022-06-21T05:03:17.713Z",
"lastModifiedDate": "2023-11-09T19:02:38.303Z",
"lockoutDate": null,
"isLockedOut": false,
"lastLockoutDate": null,
"settings": {
"userAccessTokenLifetime": "00:15:00",
"userRefreshTokenLifetime": "30.00:00:00",
"deviceAccessTokenLifetime": "00:15:00",
"deviceRefreshTokenLifetime": "730.00:00:00",
"deviceRegistrationTokenLifetime": "730.00:00:00",
"automaticTaggedPlaylistApprovalEnabled": true,
"lastModifiedDate": "2022-07-11T15:46:49.34Z"
},
"subscription": {
"id": 51116,
"level": "Content",
"creationDate": "2022-07-12T19:03:18.3Z",
"lastModifiedDate": "2023-11-09T19:02:38.2Z",
"expireDate": "2024-07-11T07:00:00Z"
}
}
]
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
POST /Self/Networks/
Creates a network for the person.
Required Scope Token
bsn.api.self.networks.create
______________________________________________________________
Request Body
The Network Entity
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
POST /2022/06/REST/Self/Networks/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
Content-Type: application/json
Content-Length: 581
This is the example request body:
{
"id": 0,
"name": "TestDisplay",
"creationDate": "0001-01-01T00:00:00",
"lastModifiedDate": "0001-01-01T00:00:00",
"lockoutDate": null,
"isLockedOut": false,
"lastLockoutDate": null,
"settings": {
"userAccessTokenLifetime": "00:15:00",
"userRefreshTokenLifetime": "1.00:00:00",
"deviceAccessTokenLifetime": "00:15:00",
"deviceRefreshTokenLifetime": "730.00:00:00",
"deviceRegistrationTokenLifetime": "730.00:00:00",
"automaticTaggedPlaylistApprovalEnabled": false,
"lastModifiedDate": "0001-01-01T00:00:00"
},
"subscription": null
}
______________________________________________________________
Response
Success Response Body
201: Returns the new resource created and referenced by the Uri (given by the Location header field) in the response. The response includes the network entity (see Network Entity).
Example
{
"id": 56448,
"name": "TestDisplay",
"creationDate": "2023-12-07T18:29:58.5041056Z",
"lastModifiedDate": "2023-12-07T18:29:58.5041056Z",
"lockoutDate": null,
"isLockedOut": false,
"lastLockoutDate": null,
"settings": {
"userAccessTokenLifetime": "00:15:00",
"userRefreshTokenLifetime": "1.00:00:00",
"deviceAccessTokenLifetime": "00:15:00",
"deviceRefreshTokenLifetime": "730.00:00:00",
"deviceRegistrationTokenLifetime": "730.00:00:00",
"automaticTaggedPlaylistApprovalEnabled": false,
"lastModifiedDate": "2023-12-07T18:29:58.5041056Z"
},
"subscription": {
"id": 88679,
"level": "Control",
"creationDate": "2023-12-07T18:29:58.5142438Z",
"lastModifiedDate": "2023-12-07T18:29:58.5142438Z",
"expireDate": null
}
}
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
415: The server cannot accept the data representation that you sent (as specified in the "Content-Type" header)
5XX: Any 500 code is an internal server error
GET /Self/Networks/{id:int}/
Get a network associated with a specified id
Required Scope Token
bsn.api.self.networks.retrieve
______________________________________________________________
Segment
id int
The unique identifier for a network
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
idis set to5732
GET /2022/06/REST/Self/Networks/5732/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response with Body
200: Returns the Network Entity
Success Response
304: The resource was not modified since the time specified in the “If-Modified-Since” header
Example
This is an example of a 200 level response:
{
"id": 5732,
"name": "StephanieMTesting",
"creationDate": "2020-07-09T19:09:04.937Z",
"lastModifiedDate": "2020-07-09T19:09:04.937Z",
"lockoutDate": null,
"isLockedOut": false,
"lastLockoutDate": null,
"settings": {
"userAccessTokenLifetime": "00:15:00",
"userRefreshTokenLifetime": "1.00:00:00",
"deviceAccessTokenLifetime": "00:15:00",
"deviceRefreshTokenLifetime": "730.00:00:00",
"deviceRegistrationTokenLifetime": "730.00:00:00",
"automaticTaggedPlaylistApprovalEnabled": false,
"lastModifiedDate": "2020-07-09T19:09:06.77Z"
},
"subscription": {
"id": 14819,
"level": "Content",
"creationDate": "2020-08-17T20:49:45.633Z",
"lastModifiedDate": "2020-08-17T20:49:45.633Z",
"expireDate": "2030-08-16T00:00:00Z"
}
}
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
PATCH /Self/Networks/{networkId:int}/
Applies changes to a network associated with a specified id
Required Scope Token
bsn.api.self.networks.update
______________________________________________________________
Segment
networkId int
The unique identifier for a network
______________________________________________________________
Request Body
These properties are entries in an array. Every entry must have all three of these properties:
op string: The type of operation - in this case it is always "replace"
path string: A Uri path that references the location within the target document where the update will be performed
value: The replacement value(s) for the id or serial of the group(s). This can be an array.
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
networkIdis set to5732
PATCH /2022/06/REST/Self/Networks/5732/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
Content-Type: application/json
Content-Length: 94
This is the example request body:
[
{
"op": "replace",
"path": "/subscription/level/",
"value": "Trial"
}
]
______________________________________________________________
Response
Success
204: The parameters have been successfully replaced
Failure
400: The request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
412: Precondition failed (the resource changed since the time specified in the “If-Unmodified-Since” header value)
415: The server cannot accept the data representation that you sent (as specified in the "Content-Type" header)
5XX: Any 500 code is an internal server error
GET /Self/Networks/{name}/
Returns a network associated with a specified name.
Required Scope Token
bsn.api.self.networks.retrieve
______________________________________________________________
Segment
name string
The name of a network
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
nameis set toStephanieMTesting
GET /2022/06/REST/Self/Networks/StephanieMTesting/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response Body
200: Returns the Network Entity
Success Response
304: The resource was not modified since the time specified in the “If-Modified-Since” header
Example
This is an example of a 200 level response:
{
"id": 5732,
"name": "StephanieMTesting",
"creationDate": "2020-07-09T19:09:04.937Z",
"lastModifiedDate": "2020-07-09T19:09:04.937Z",
"lockoutDate": null,
"isLockedOut": false,
"lastLockoutDate": null,
"settings": {
"userAccessTokenLifetime": "00:15:00",
"userRefreshTokenLifetime": "30.00:00:00",
"deviceAccessTokenLifetime": "00:15:00",
"deviceRefreshTokenLifetime": "730.00:00:00",
"deviceRegistrationTokenLifetime": "730.00:00:00",
"automaticTaggedPlaylistApprovalEnabled": false,
"lastModifiedDate": "2023-12-07T21:41:44.01Z"
},
"subscription": {
"id": 14819,
"level": "Content",
"creationDate": "2020-08-17T20:49:45.633Z",
"lastModifiedDate": "2020-08-17T20:49:45.633Z",
"expireDate": "2030-08-16T00:00:00Z"
}
}
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
PATCH /Self/Networks/{networkName}/
Applies changes to a network associated with a specified id
Required Scope Token
bsn.api.self.networks.update
______________________________________________________________
Segment
networkName string
The name of the network
______________________________________________________________
Request Body
These properties are entries in an array. Every entry must have all three of these properties:
op string: The type of operation - in this case it is always "replace"
path string: A Uri path that references the location within the target document where the update will be performed
value: The replacement value(s) for the id or serial of the group(s). This can be an array.
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
networkNameis set toStephanieMTesting
PATCH /2022/06/REST/Self/Networks/StephanieMTesting/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
Content-Type: application/json
Content-Length: 94
This is the example request body:
[
{
"op": "replace",
"path": "/?/",
"value": "?"
}
]
______________________________________________________________
Response
Success
204: The parameters have been successfully replaced
Failure
400: The request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
412: Precondition failed (the resource changed since the time specified in the “If-Unmodified-Since” header value)
415: The server cannot accept the data representation that you sent (as specified in the "Content-Type" header)
5XX: Any 500 code is an internal server error
GET /Self/Networks/{id:int}/Settings/
Returns the settings associated with a specified network.
Required Scope Token
bsn.api.self.networks.retrieve
______________________________________________________________
Segment
id int
The unique identifier for a network
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
idis set to5732
GET /2022/06/REST/Self/Networks/5732/Settings/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response with Body
200: Returns the Network Settings Entity
Success Response
304: The resource was not modified since the time specified in the “If-Modified-Since” header
Example
{
"userAccessTokenLifetime": "00:15:00",
"userRefreshTokenLifetime": "1.00:00:00",
"deviceAccessTokenLifetime": "00:15:00",
"deviceRefreshTokenLifetime": "730.00:00:00",
"deviceRegistrationTokenLifetime": "730.00:00:00",
"automaticTaggedPlaylistApprovalEnabled": false,
"lastModifiedDate": "2020-07-09T19:09:06.77Z"
}
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
PUT /Self/Networks/{id:int}/Settings/
Update the settings associated with a specified network
Required Scope Token
bsn.api.self.networks.update
______________________________________________________________
Segment
id int
The unique identifier for a network
______________________________________________________________
Request Body
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
idis set to5732
PUT /2022/06/REST/Self/Networks/5732/Settings/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
Content-Type: application/json
Content-Length: 335
This is the example request body:
{
"userAccessTokenLifetime": "00:15:00",
"userRefreshTokenLifetime": "30.00:00:00",
"deviceAccessTokenLifetime": "00:15:00",
"deviceRefreshTokenLifetime": "730.00:00:00",
"deviceRegistrationTokenLifetime": "730.00:00:00",
"automaticTaggedPlaylistApprovalEnabled": false,
"lastModifiedDate": "0001-01-01T00:00:00"
}
______________________________________________________________
Response
Success
204: The specified settings have been updated on the network
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
415: The server cannot accept the data representation that you sent (as specified in the "Content-Type" header)
5XX: Any 500 code is an internal server error
GET /Self/Networks/{name}/Settings/
Get the settings associated with a specified network.
Required Scope Token
bsn.api.self.networks.retrieve
______________________________________________________________
Segment
name string
The network name
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
idis set toStephanieMTesting
GET /2022/06/REST/Self/Networks/StephanieMTesting/Settings/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response Body
200: Returns the Network Settings Entity
Example
{
"userAccessTokenLifetime": "00:15:00",
"userRefreshTokenLifetime": "1.00:00:00",
"deviceAccessTokenLifetime": "00:15:00",
"deviceRefreshTokenLifetime": "730.00:00:00",
"deviceRegistrationTokenLifetime": "730.00:00:00",
"automaticTaggedPlaylistApprovalEnabled": false,
"lastModifiedDate": "2020-07-09T19:09:06.77Z"
}
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
PUT /Self/Networks/{name}/Settings/
Update the settings associated with a specified network
Required Scope Token
bsn.api.self.networks.update
______________________________________________________________
Segment
name string
The network name
______________________________________________________________
Request Body
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
nameis set toStephanieMTesting
PUT /2022/06/REST/Self/Networks/StephanieMTesting/Settings/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
Content-Type: application/json
Content-Length: 335
This is the example request body:
{
"userAccessTokenLifetime": "00:15:00",
"userRefreshTokenLifetime": "30.00:00:00",
"deviceAccessTokenLifetime": "00:15:00",
"deviceRefreshTokenLifetime": "730.00:00:00",
"deviceRegistrationTokenLifetime": "730.00:00:00",
"automaticTaggedPlaylistApprovalEnabled": false,
"lastModifiedDate": "0001-01-01T00:00:00"
}
______________________________________________________________
Response
Success
204: The network settings have been updated
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
415: The server cannot accept the data representation that you sent (as specified in the "Content-Type" header)
5XX: Any 500 code is an internal server error
GET /Self/Networks/{id:int}/Subscription/
Returns the current subscription information associated with a specified network.
Required Scope Token
bsn.api.self.networks.retrieve
______________________________________________________________
Segment
id int
The unique identifier for a network
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
idis set to5732
GET /2022/06/REST/Self/Networks/5732/Subscription/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response with Body
200: Returns the Network Subscription Entity
Success Response
304: The resource was not modified since the time specified in the “If-Modified-Since” header
Example
{
"id": 14819,
"level": "Content",
"creationDate": "2020-08-17T20:49:45.633Z",
"lastModifiedDate": "2020-08-17T20:49:45.633Z",
"expireDate": "2030-08-16T00:00:00Z"
}
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
PUT /Self/Networks/{id:int}/Subscription/
Updates the current subscription information associated with a specified network. A regular user can only use this to enable a trial period of the Content Cloud (if it was not previously enabled).
Required Scope Token
bsn.api.self.networks.update
______________________________________________________________
Segment
id int
The unique identifier for a network
______________________________________________________________
Request Body
The Network Subscription Entity
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
idis set to5732
PUT /2022/06/REST/Self/Networks/5732/Subscription/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
Content-Type: application/json
Content-Length: 114
This is the example request body:
{
"id": 0,
"level": "Content",
"creationDate": "0001-01-01T00:00:00",
"lastModifiedDate": "0001-01-01T00:00:00",
"expireDate": null
}
______________________________________________________________
Response
Success
204: The subscription information was updated
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
412: Precondition failed (the resource changed since the time specified in the “If-Unmodified-Since” header value)
415: The server cannot accept the data representation that you sent (as specified in the "Content-Type" header)
5XX: Any 500 code is an internal server error
GET /Self/Networks/{name}/Subscription/
Returns the current subscription information associated with a specified network.
Required Scope
bsn.api.self.networks.retrieve
______________________________________________________________
Segment
name string
The network name
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
nameis set toStephanieMTesting
GET /2022/06/REST/Self/Networks/StephanieMTesting/Subscription/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response Body
200: Returns the Network Subscription Entity
Example
{
"id": 14819,
"level": "Content",
"creationDate": "2020-08-17T20:49:45.633Z",
"lastModifiedDate": "2020-08-17T20:49:45.633Z",
"expireDate": "2030-08-16T00:00:00Z"
}
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
PUT /Self/Networks/{name}/Subscription/
Updates the current subscription information associated with a specified network. A regular user can only use this to enable a trial period of the Content Cloud (if it was not previously enabled).
Required Scope Token
bsn.api.self.networks.update
______________________________________________________________
Segment
name string
The network name
______________________________________________________________
Request Body
The Network Subscription Entity
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
nameis set toStephanieMTesting
PUT /2022/06/REST/Self/Networks/StephanieMTesting/Subscription/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
Content-Type: application/json
Content-Length: 114
This is the example request body:
{
"id": 0,
"level": "Trial",
"creationDate": "0001-01-01T00:00:00",
"lastModifiedDate": "0001-01-01T00:00:00",
"expireDate": null
}
______________________________________________________________
Response
Success
204: Updated the subscription information associated with the network
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
415: The server cannot accept the data representation that you sent (as specified in the "Content-Type" header)
5XX: Any 500 code is an internal server error
GET /Self/Networks/{id:int}/Subscriptions/
Returns the current subscription, and all previously expired subscriptions, associated with a specified network
Required Scope Token
bsn.api.self.networks.retrieve
______________________________________________________________
Segment
id int
The network identifier
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
idis set to5732
GET /2022/06/REST/Self/Networks/5732/Subscriptions/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response Body
200: Returns an array of Network Subscription entities
Example
[
{
"id": 14819,
"level": "Content",
"creationDate": "2020-08-17T20:49:45.633Z",
"lastModifiedDate": "2020-08-17T20:49:45.633Z",
"expireDate": "2030-08-16T00:00:00Z"
},
{
"id": 12598,
"level": "Trial",
"creationDate": "2020-07-24T23:05:45.517Z",
"lastModifiedDate": "2020-07-24T23:05:45.517Z",
"expireDate": "2020-08-17T20:49:45.633Z"
},
{
"id": 12101,
"level": "Control",
"creationDate": "2020-07-09T19:09:05.853Z",
"lastModifiedDate": "2020-07-09T19:09:05.853Z",
"expireDate": "2020-07-24T23:05:45.517Z"
}
]
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
GET /Self/Networks/{name}/Subscriptions/
Returns the current subscription, and all previously expired subscriptions, associated with a specified network
Required Scope Token
bsn.api.self.networks.retrieve
______________________________________________________________
Segment
name string
The network name
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
nameis set toStephanieMTesting
GET /2022/06/REST/Self/Networks/StephanieMTesting/Subscriptions/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response Body
200: Returns an array of Network Subscription entities
Example
[
{
"id": 14819,
"level": "Content",
"creationDate": "2020-08-17T20:49:45.633Z",
"lastModifiedDate": "2020-08-17T20:49:45.633Z",
"expireDate": "2030-08-16T00:00:00Z"
},
{
"id": 12598,
"level": "Trial",
"creationDate": "2020-07-24T23:05:45.517Z",
"lastModifiedDate": "2020-07-24T23:05:45.517Z",
"expireDate": "2020-08-17T20:49:45.633Z"
},
{
"id": 12101,
"level": "Control",
"creationDate": "2020-07-09T19:09:05.853Z",
"lastModifiedDate": "2020-07-09T19:09:05.853Z",
"expireDate": "2020-07-24T23:05:45.517Z"
}
]
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
GET /Self/Users/
Returns all user entities that the customer is associated with over all networks where the person has a user record
Required Scope Token
bsn.api.self.users.retrieve
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
GET /2022/06/REST/Self/Users/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response Body
200: Returns an array of user entities (see User Entity) if the user is a member of multiple networks, or to a single User Entity if the user is only a member of one network, or nothing if the user is not a member of any network.
Example
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
GET /Self/Users/{id:int}/
Returns information about your membership in a network
Required Scope Token
bsn.api.self.users.retrieve
______________________________________________________________
Segment
id int
The unique identifier for a user
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
idis set to8230
GET /2022/06/REST/Self/Users/8230/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response with Body
200: Returns the User Entity
Success Response
304: The resource was not modified since the time specified in the “If-Modified-Since” header
Example with Body
{
"id": 8230,
"person": {
"id": 7349,
"login": "smulqueen@brightsign.biz",
"password": null,
"firstName": "Stephanie",
"lastName": "Mulqueen",
"creationDate": "2020-07-09T19:05:20.247Z",
"lastModifiedDate": "2023-11-29T17:40:54.403Z",
"activationDate": "2020-07-09T19:05:38.723Z"
},
"network": {
"id": 5732,
"name": "StephanieMTesting"
},
"description": "Network Administrator",
"creationDate": "2020-07-09T19:09:04.98Z",
"lastModifiedDate": "2020-08-17T20:49:48.377Z",
"lastLoginDate": "2023-12-07T23:20:47.5Z",
"isLockedOut": false,
"lastLockoutDate": null,
"roleName": "Administrators",
"permissions": [
{
"entityId": 30912,
"operationUID": "67b9b0ab-fb5f-36c4-d598-a71aa8998e4e",
"principal": {
"login": "smulqueen@brightsign.biz",
"type": "User",
"id": 8230
},
"isFixed": true,
"isInherited": false,
"isAllowed": true,
"creationDate": "2020-08-17T20:49:48.353Z"
},
{
"entityId": 30913,
"operationUID": "67b9b0ab-fb5f-36c4-d598-a71aa8998e4e",
"principal": {
"login": "smulqueen@brightsign.biz",
"type": "User",
"id": 8230
},
"isFixed": true,
"isInherited": false,
"isAllowed": true,
"creationDate": "2020-08-17T20:49:48.377Z"
}
]
}
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
GET /Self/Users/{id:int}/Role/
Returns information about the role you have in a network
Required Scope Token
bsn.api.self.roles.retrieve
______________________________________________________________
Segment
id int
The unique identifier for a user
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
idis set to8230
GET /2022/06/REST/Self/Users/8230/Role/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response with Body
200: This returns the User Entity
Success Response
204: No content (the user is not assigned to a role)
Example with Body
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
GET /Self/Users/{id:int}/Profile/
Returns the user profile settings
Required Scope Token
bsn.api.self.users.profile.retrieve
______________________________________________________________
Segment
id int
The unique identifier for a user
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
idis set to8230
GET /2022/06/REST/Self/Users/8230/Profile/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
______________________________________________________________
Response
Success Response Body
200: The return type is object, where property names are profile keys and the profile values are those property values
Example
{
"brightAuthorAccessLevel": "BA Administrators",
"enableCustomRolesManagement": "true",
"showAdvancedSecuritySettings": "False",
"userStartupPage": "Settings"
}
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
POST /Self/Users/{id:int}/Profile/
Creates a new user profile property (it does not replace an existing user profile property)
Required Scope Token
bsn.api.self.users.profile.update
______________________________________________________________
Segment
id int
The unique identifier for a user
______________________________________________________________
Request Body
pair <string, string>
A key value pair. There should be not more than 100 properties per user, and each property value should be not more than 64KB.
______________________________________________________________
Request Example
The example request parameters and headers are set as follows:
idis set to8230
POST /2022/06/REST/Self/Users/8230/Profile/ HTTP/1.1
Host: api.bsn.cloud
Connection: Keep-Alive
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Accept-Encoding: gzip,deflate
Content-Type: application/json
Content-Length: 45
This is the example request body:
{
"key": "New Key 1",
"value": "My Value"
}
______________________________________________________________
Response
Success Response Body
201: Returns the key value pair and a link to the GET method to retrieve it.
Example
{
"key": "New Key 1",
"value": "My Value"
}
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
409: The profile property with the specified key already exists or is reserved
413: The specified profile property value size exceeds the 64KB limit
415: The server cannot accept the data representation that you sent (as specified in the "Content-Type" header)
5XX: Any 500 code is an internal server error
GET /Self/Users/{id:int}/Profile/{key}/
Returns the value of a user profile property
Required Scope Token
bsn.api.self.users.profile.retrieve
______________________________________________________________
Segment
id int
The unique identifier for a user
key string
The name of the profile property
______________________________________________________________
Response
Success Response with Body
200: Returns the value of the requested user profile key
Success Response
304: The resource was not modified since the time specified in the “If-Modified-Since” header
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
PUT /Self/Users/{id:int}/Profile/{key}/
Creates or updates the value of a user profile property
Required Scope Token
bsn.api.self.users.profile.update
______________________________________________________________
Segments
id int
The unique identifier for a user
key string
The name of the profile property
______________________________________________________________
Request Body
string
The profile property value to update
______________________________________________________________
Response
Success
201: Returns this status code if the property value is defined for first time
204: Returns this status code if the property already exists and has been updated
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: Either the request is malformed and therefore invalid, or the specified user profile property key is reserved or longer than 62 characters
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
412: Precondition failed (the resource changed since the time specified in the “If-Unmodified-Since” header value)
413: The length of the specified user profile property exceeds the 64KB limit
415: The server cannot accept the data representation that you sent (as specified in the "Content-Type" header)
5XX: Any 500 code is an internal server error
DELETE /Self/Users/{id:int}/Profile/{key}/
Removes a specified property from a user profile
Required Scope Token
bsn.api.self.users.profile.update
______________________________________________________________
Segments
id int
The unique identifier for a user
key string
The name of the profile property
______________________________________________________________
Response
Success
204: The specified property has been removed from the user profile
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
412: Precondition failed (the resource changed since the time specified in the “If-Unmodified-Since” header value)
5XX: Any 500 code is an internal server error
GET /Self/Profile/
Returns a complete person profile
Required Scope Token
bsn.api.self.profile.retrieve
______________________________________________________________
Response
Success Response with Body
200: The return type is object, where property names are profile keys and the profile values are those property values
Failure
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
5XX: Any 500 code is an internal server error
POST /Self/Profile/
Creates a new profile property for a person
Required Scope Token
bsn.api.self.profile.update
______________________________________________________________
Request Body
pair <string, string>
A key value pair of the person profile property
______________________________________________________________
Response
Success Response Body
201: Returns the new resource created and referenced by the Uri (given by the Location header field) in the response. Returns an object where property names correspond to profile keys and property values correspond to profile names.
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: Either the request is malformed and therefore invalid, or the specified profile property key is reserved or longer than 62 characters
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
409: The person profile property with the specified key already exists
413: The length of the specified person property profile value exceeds the 64KB limit
415: The server cannot accept the data representation that you sent (as specified in the "Content-Type" header)
5XX: Any 500 code is an internal server error
GET /Self/Profile/{key}/
Returns a profile property value for a person
Required Scope Token
bsn.api.self.profile.retrieve
______________________________________________________________
Segment
key string
The name of the profile property
______________________________________________________________
Response
Success Response Body
200: Returns a profile property value
Success Response
304: The resource was not modified since the time specified in the “If-Modified-Since” header
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
PUT /Self/Profile/{key}/
Creates or updates a person profile property value
Required Scope Token
bsn.api.self.profile.update
______________________________________________________________
Segment
key string
The name of the profile property
______________________________________________________________
Request Body
string
The profile property value to update
______________________________________________________________
Response
Success
201: Returns this status code if the person property value is defined for first time
204: Returns this status code if the person property value already exists and has been updated
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
412: Precondition failed (the resource changed since the time specified in the “If-Unmodified-Since” header value)
413: The length of the specified user profile property exceeds the 64KB limit
415: The server cannot accept the data representation that you sent (as specified in the "Content-Type" header)
5XX: Any 500 code is an internal server error
DELETE /Self/Profile/{key}/
Removes a profile property for a person
Required Scope Token
bsn.api.self.profile.update
______________________________________________________________
Segment
key string
The name of the profile property
______________________________________________________________
Response
Success
204: The profile property has been removed
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
412: Precondition failed (the resource changed since the time specified in the “If-Unmodified-Since” header value)
5XX: Any 500 code is an internal server error
GET /Self/Users/{id:int}/Permissions/
Returns the permissions granted to a given user
Required Scope Token
bsn.api.self.users.retrieve
______________________________________________________________
Segment
id int
A unique identifier for a user
______________________________________________________________
Response
Success Response Body
200: Returns the paged list of Permission entities granted to a specific user
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
GET /Self/Users/{id:int}/Role/Permissions/
Returns permissions granted to a given user
Required Scope Token
bsn.api.self.roles.retrieve
______________________________________________________________
Segment
id int
A unique identifier for a user
______________________________________________________________
Response
Success Response Body
200: Returns the array of Permission entities granted to a specific role
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
GET /Self/Users/{id:int}/Notifications/
Returns the user notification settings
Required Scope Token
bsn.api.self.users.notifications.retrieve
______________________________________________________________
Segment
id int
A unique identifier for a user
______________________________________________________________
Response
Success Response Body
200: Returns information about whether each setting in User Notification Settings Entity is enabled or disabled
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request is malformed and therefore invalid
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
5XX: Any 500 code is an internal server error
PUT /Self/Users/{id:int}/Notifications/
Updates the user notification settings
Required Scope Token
bsn.api.self.users.notifications.update
______________________________________________________________
Segment
id int
A unique identifier for a user
______________________________________________________________
Request Body
The User Notification Settings Entity
______________________________________________________________
Response
Success
204: The specified user notification settings have been updated on the network
Failure
300: The requested representation could not be returned because it is ambiguous (there are multiple requested representations)
400: The request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules
401: The access token is invalid or not specified
403: The supplied access token, though valid, doesn't provide access to this method
404: The server cannot find the requested resource (the path does not exist)
406: The server cannot return the data representation that you requested (as specified in the "Accept" header)
415: The server cannot accept the data representation that you sent (as specified in the "Content-Type" header)
5XX: Any 500 code is an internal server error