Cloud APIs
...
BSN.Cloud Main APIs
Main API version 2022/06

WebPages Endpoints (2022/06)

37min
these endpoints allow users to manage webpages (that is, an html file and associated asset files) on a network base url for these endpoints https //api bsn cloud/2022/06/rest/webpages get / returns a list of webpages on a network required scope token bsn api main webpages retrieve query string parameters filter string string optional optional an filtering and sorting expressions in the main api docid 3l0afyd3xooe ytvfk2vs for filtering search results the default value is null sort string string optional optional an expression for sorting the search results the sort expression specifies the entry used for sorting and the ascending/descending (asc/desc) sorting order (e g " \[device] \[serial] asc ") the default value is null marker string string optional optional 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 webpage instances exceeds the pagesize this parameter is only required if you need more elements in the paged list than the pagesize (100) pagesize int int optional optional the maximum number of webpage instances that can be contained in the response body this defaults to the maximum allowed page size (100) request example the example request parameters and headers are set as follows filter is set to \[uploaddate] is in the range '2020 01 01' and '2024 01 01' sort is set to \[name] asc marker value is set to the \[pagedlist] \[nextmarker] property value from the previous bsn cloud api response pagesize is set to 1 get /2022/06/rest/webpages/?marker=y29udhjwxmju5otg2ng%3d%3d\&pagesize=1\&filter=%5buploaddate%5d%20is%20in%20the%20range%20%272020 01 01%27%20and%20%272024 01 01%27\&sort=%5bname%5d%20asc 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 success response body 200 200 returns a paged list entity (2022/06) docid\ pwwr0ln3 binngl mr3st of webpage entity (2022/06) docid\ o5v0ui933wvereinm7ls7 instances on a network this will return not more than 100 entities along with the information necessary to return any other remaining pages example { "items" \[ { "id" 12345, "name" "presentationbsdatetimewidget", "uploaddate" "2023 07 26t19 35 26 087z", "lastmodifieddate" "2023 07 26t19 35 26 087z", "indexfile" { "filename" "bsdatetimewidget html", "physicalpath" "https //bsncloud s3 amazonaws com/janedoe/3285cf5ee2926a8b47e30b12f51ed169", "relativepath" "\\\\", "filesize" 2084573, "filehash" "sha1 69780c154749dfe32b04459b7103c07b11e0da59" }, "assets" null, "presentations" \[ { "id" 123, "name" "clockzone", "type" "presentation", "link" null }], "permissions" \[] }], "totalitemcount" 6, "matchingitemcount" 6, "pagesize" 1, "nextmarker" "rgvmyxvsdf9qcmvzzw50yxrpb25cc0rhdgvuaw1lv2lkz2v0ldewmdm3mju0", "prevmarker" "rgvmyxvsdf9qcmvzzw50yxrpb25cc0rhdgvuaw1lv2lkz2v0ldewmdm31gh2", "istruncated" true, "sortexpression" "\[name] asc", "filterexpression" "\[uploaddate] is in the range '2020 01 01t00 00 00 000z' and '2024 01 01t00 00 00 000z'" } failure response 300 300 the requested representation could not be returned because it is ambiguous (there are multiple requested representations) 400 400 the request is malformed and therefore invalid 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 406 406 the server cannot return the data representation that you requested (as specified in the "accept" header) 5xx 5xx any 500 code is an internal server error delete / deletes webpages, specified by a filter, on a network this allows multiple webpages to be deleted at once required scope token bsn api main webpages delete query string parameter filter string string required required an filtering and sorting expressions in the main api docid 3l0afyd3xooe ytvfk2vs for filtering search results request example the example request parameters and headers are set as follows filter is set to \[uploaddate] is in the range '2019 01 01' and '2020 01 01' delete /2022/06/rest/webpages/?filter=%5buploaddate%5d%20is%20in%20the%20range%20%272019 01 01%27%20and%20%272020 01 01%27 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 success response 200 200 returns the number of affected webpages, as an integer value failure response 300 300 the requested representation could not be returned because it is ambiguous (there are multiple requested representations) 400 400 the request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules for example, you cannot delete a webpage that is in use by a presentation 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 406 406 the server cannot return the data representation that you requested (as specified in the "accept" header) 5xx 5xx any 500 code is an internal server error get /count/ returns the number of webpages on a network required scope token bsn api main webpages retrieve query string parameters filter string string optional optional an filtering and sorting expressions in the main api docid 3l0afyd3xooe ytvfk2vs for filtering search results the default value is null request example the example request parameters and headers are set as follows filter is set to \[uploaddate] is in the range '2020 01 01' and '2024 01 01' get /2022/06/rest/webpages/count/?filter=%5buploaddate%5d%20is%20in%20the%20range%20%272020 01 01%27%20and%20%272024 01 01%27 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 success response body 200 200 the webpage count is returned as an integer value failure response 300 300 the requested representation could not be returned because it is ambiguous (there are multiple requested representations) 400 400 the request is malformed and therefore invalid 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 406 406 the server cannot return the data representation that you requested (as specified in the "accept" header) 5xx 5xx any 500 code is an internal server error get /{id\ int}/ returns the specified webpage required scope token bsn api main webpages retrieve segment id int int a unique identifier for the webpage request example the example request parameters and headers are set as follows id is set to 12345 the optional if modified since header value equals the last modified header value retrieved from the previous get /id or get /name response get /2022/06/rest/webpages/12345/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} if modified since wed, 20 dec 2023 21 32 34 gmt accept application/json, application/vnd bsn error+json accept encoding gzip,deflate success response with body 200 200 returns the webpage entity (2022/06) docid\ o5v0ui933wvereinm7ls7 example this is an example of a 200 level response { "id" 12345, "name" "presentationbsdatetimewidget", "uploaddate" "2023 07 26t19 35 26 087z", "lastmodifieddate" "2023 12 20t21 32 35 093z", "indexfile" { "filename" "bsdatetimewidget html", "physicalpath" "https //bsncloud s3 amazonaws com/janedoe/3285cf5ee2926a8b47e30b12f51ed169", "relativepath" "\\\\", "filesize" 2084573, "filehash" "sha1 69782c054749dfe39b94859b7103c07b11e0da59" }, "assets" \[], "presentations" \[ { "id" 123, "name" "clockzone", "type" "presentation", "link" null }], "permissions" \[] } success response 304 304 the resource was not modified since the time specified in the “if modified since” header failure response 300 300 the requested representation could not be returned because it is ambiguous (there are multiple requested representations) 400 400 the request is malformed and therefore invalid 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 404 404 the server cannot find the requested resource (the path does not exist) 406 406 the server cannot return the data representation that you requested (as specified in the "accept" header) 5xx 5xx any 500 code is an internal server error delete /{id\ int}/ deletes the specified webpage required scope token bsn api main webpages delete segment id int int a unique identifier for the webpage request example the example request parameters and headers are set as follows id is set to 12345 the optional if unmodified since header value equals the last modified header value retrieved from the get /id or get /name response delete /2022/06/rest/webpages/12345/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} if unmodified since wed, 20 dec 2023 21 32 34 gmt accept application/json, application/vnd bsn error+json accept encoding gzip,deflate success response 204 204 the specified webpage was deleted failure response 300 300 the requested representation could not be returned because it is ambiguous (there are multiple requested representations) 400 400 the request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules for example, you cannot delete a webpage that is in use by a presentation 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 404 404 the server cannot find the requested resource (the path does not exist) 406 406 the server cannot return the data representation that you requested (as specified in the "accept" header) 412 412 precondition failed (the resource changed since the time specified in the “if unmodified since” header value) 5xx 5xx any 500 code is an internal server error get /{name}/ returns the specified webpage required scope token bsn api main webpages retrieve segment name string string a unique identifier for the webpage request example the example request parameters and headers are set as follows name is set to presentationbsdatetimewidget the optional if modified since header value equals the last modified header value retrieved from the previous get /id or get /name response get /2022/06/rest/webpages/presentationbsdatetimewidget/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} if modified since wed, 20 dec 2023 21 32 34 gmt accept application/json, application/vnd bsn error+json accept encoding gzip,deflate success response with body 200 200 returns the webpage entity (2022/06) docid\ o5v0ui933wvereinm7ls7 example this is an example of a 200 level response { "id" 12345, "name" "presentationbsdatetimewidget", "uploaddate" "2023 07 26t19 35 26 087z", "lastmodifieddate" "2023 12 20t21 32 35 093z", "indexfile" { "filename" "bsdatetimewidget html", "physicalpath" "https //bsncloud s3 amazonaws com/janedoe/3285cf5ee2926a8b47e30b12f51ed169", "relativepath" "\\\\", "filesize" 2084573, "filehash" "sha1 69782c054749dfe39b94859b7103c07b11e0da59" }, "assets" \[], "presentations" \[ { "id" 123, "name" "clockzone", "type" "presentation", "link" null }], "permissions" \[] } success response 304 304 the resource was not modified since the time specified in the “if modified since” header failure response 300 300 the requested representation could not be returned because it is ambiguous (there are multiple requested representations) 400 400 the request is malformed and therefore invalid 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 404 404 the server cannot find the requested resource (the path does not exist) 406 406 the server cannot return the data representation that you requested (as specified in the "accept" header) 5xx 5xx any 500 code is an internal server error delete /{name}/ deletes the specified webpage required scope token bsn api main webpages delete segment name string string a unique identifier for the webpage request example the example request parameters and headers are set as follows name is set to presentationbsdatetimewidget the optional if unmodified since header value equals the last modified header value retrieved from the get /id or get /name response delete /2022/06/rest/webpages/presentationbsdatetimewidget/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} if unmodified since wed, 20 dec 2023 21 32 34 gmt accept application/json, application/vnd bsn error+json accept encoding gzip,deflate success response 204 204 the specified webpage was deleted failure response 300 300 the requested representation could not be returned because it is ambiguous (there are multiple requested representations) 400 400 the request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules for example, you cannot delete a webpage that is in use by a presentation 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 404 404 the server cannot find the requested resource (the path does not exist) 406 406 the server cannot return the data representation that you requested (as specified in the "accept" header) 412 412 precondition failed (the resource changed since the time specified in the “if unmodified since” header value) 5xx 5xx any 500 code is an internal server error get /operations/ returns the operational permissions granted to roles for specific business operations required scope token bsn api main operations retrieve request example the example request parameters and headers are set as follows get /2022/06/rest/webpages/operations/ 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 success response body 200 200 returns the business operations entity (2022/06) docid\ ei98k7oul6z5i 5b d6js example { "uid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "singularname" "full control", "pluralname" "web page (full control)", "fullname" "web page (full control)", "targetentity" "webpage", "appliance" "instance, collection", "parent" null, "descendants" \[ { "uid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "singularname" "view web page", "pluralname" "view web pages", "fullname" "web page (full control) view web pages", "targetentity" "webpage", "appliance" "instance, collection", "parent" { "uid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "singularname" "full control", "pluralname" "web page (full control)", "fullname" "web page (full control)", "targetentity" "webpage", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2022 06 21t05 03 20 16z" }, { "entityid" null, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2022 06 21t05 03 20 42z" }, { "entityid" null, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 44z" }, { "entityid" null, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 54z" }, { "entityid" null, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 66z" }, { "entityid" null, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 19 82z" }, { "entityid" null, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "no permissions", "iscustom" true, "type" "role", "id" 10410 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 08 29t23 08 25 9z" }, { "entityid" null, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "roll 1", "iscustom" true, "type" "role", "id" 10470 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 04 293z" }, { "entityid" null, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "roll 2", "iscustom" true, "type" "role", "id" 10471 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 25 703z" }, { "entityid" null, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "no setup", "iscustom" true, "type" "role", "id" 10706 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 07t19 42 05 667z" }, { "entityid" null, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "matty boom", "iscustom" true, "type" "role", "id" 10714 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 09t17 11 57 69z" }, { "entityid" null, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "live feed", "iscustom" true, "type" "role", "id" 10795 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 12 11t22 09 07 977z" } ] }, { "uid" "3860874d bbb3 49cf 8ae5 c580f0480df2", "singularname" "upload web page", "pluralname" "upload web page", "fullname" "web page (full control) upload web page", "targetentity" "webpage", "appliance" "collection", "parent" { "uid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "singularname" "full control", "pluralname" "web page (full control)", "fullname" "web page (full control)", "targetentity" "webpage", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "3860874d bbb3 49cf 8ae5 c580f0480df2", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 44z" }, { "entityid" null, "operationuid" "3860874d bbb3 49cf 8ae5 c580f0480df2", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 54z" }, { "entityid" null, "operationuid" "3860874d bbb3 49cf 8ae5 c580f0480df2", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 66z" }, { "entityid" null, "operationuid" "3860874d bbb3 49cf 8ae5 c580f0480df2", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 19 82z" }, { "entityid" null, "operationuid" "3860874d bbb3 49cf 8ae5 c580f0480df2", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 20 16z" }, { "entityid" null, "operationuid" "3860874d bbb3 49cf 8ae5 c580f0480df2", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 20 417z" }, { "entityid" null, "operationuid" "3860874d bbb3 49cf 8ae5 c580f0480df2", "principal" { "name" "no permissions", "iscustom" true, "type" "role", "id" 10410 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 08 29t23 08 25 9z" }, { "entityid" null, "operationuid" "3860874d bbb3 49cf 8ae5 c580f0480df2", "principal" { "name" "roll 1", "iscustom" true, "type" "role", "id" 10470 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 04 293z" }, { "entityid" null, "operationuid" "3860874d bbb3 49cf 8ae5 c580f0480df2", "principal" { "name" "roll 2", "iscustom" true, "type" "role", "id" 10471 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 25 703z" }, { "entityid" null, "operationuid" "3860874d bbb3 49cf 8ae5 c580f0480df2", "principal" { "name" "no setup", "iscustom" true, "type" "role", "id" 10706 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 07t19 42 05 667z" }, { "entityid" null, "operationuid" "3860874d bbb3 49cf 8ae5 c580f0480df2", "principal" { "name" "matty boom", "iscustom" true, "type" "role", "id" 10714 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 09t17 11 57 69z" }, { "entityid" null, "operationuid" "3860874d bbb3 49cf 8ae5 c580f0480df2", "principal" { "name" "live feed", "iscustom" true, "type" "role", "id" 10795 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 12 11t22 09 07 977z" } ] }, { "uid" "49d22ebc 696f 4db1 9138 66bcbc32dce0", "singularname" "update web page", "pluralname" "update web page", "fullname" "web page (full control) update web page", "targetentity" "webpage", "appliance" "instance, collection", "parent" { "uid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "singularname" "full control", "pluralname" "web page (full control)", "fullname" "web page (full control)", "targetentity" "webpage", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "49d22ebc 696f 4db1 9138 66bcbc32dce0", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 44z" }, { "entityid" null, "operationuid" "49d22ebc 696f 4db1 9138 66bcbc32dce0", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 54z" }, { "entityid" null, "operationuid" "49d22ebc 696f 4db1 9138 66bcbc32dce0", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 66z" }, { "entityid" null, "operationuid" "49d22ebc 696f 4db1 9138 66bcbc32dce0", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 19 82z" }, { "entityid" null, "operationuid" "49d22ebc 696f 4db1 9138 66bcbc32dce0", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 20 16z" }, { "entityid" null, "operationuid" "49d22ebc 696f 4db1 9138 66bcbc32dce0", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 20 417z" }, { "entityid" null, "operationuid" "49d22ebc 696f 4db1 9138 66bcbc32dce0", "principal" { "name" "no permissions", "iscustom" true, "type" "role", "id" 10410 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 08 29t23 08 25 9z" }, { "entityid" null, "operationuid" "49d22ebc 696f 4db1 9138 66bcbc32dce0", "principal" { "name" "roll 1", "iscustom" true, "type" "role", "id" 10470 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 04 293z" }, { "entityid" null, "operationuid" "49d22ebc 696f 4db1 9138 66bcbc32dce0", "principal" { "name" "roll 2", "iscustom" true, "type" "role", "id" 10471 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 25 703z" }, { "entityid" null, "operationuid" "49d22ebc 696f 4db1 9138 66bcbc32dce0", "principal" { "name" "no setup", "iscustom" true, "type" "role", "id" 10706 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 07t19 42 05 667z" }, { "entityid" null, "operationuid" "49d22ebc 696f 4db1 9138 66bcbc32dce0", "principal" { "name" "matty boom", "iscustom" true, "type" "role", "id" 10714 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 09t17 11 57 69z" }, { "entityid" null, "operationuid" "49d22ebc 696f 4db1 9138 66bcbc32dce0", "principal" { "name" "live feed", "iscustom" true, "type" "role", "id" 10795 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 12 11t22 09 07 977z" } ] }, { "uid" "9c44c26a 5519 4c8f ac4a 1d7b918e2349", "singularname" "assign web page", "pluralname" "assign web page", "fullname" "web page (full control) assign web page", "targetentity" "webpage", "appliance" "instance, collection", "parent" { "uid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "singularname" "full control", "pluralname" "web page (full control)", "fullname" "web page (full control)", "targetentity" "webpage", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "9c44c26a 5519 4c8f ac4a 1d7b918e2349", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 44z" }, { "entityid" null, "operationuid" "9c44c26a 5519 4c8f ac4a 1d7b918e2349", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 54z" }, { "entityid" null, "operationuid" "9c44c26a 5519 4c8f ac4a 1d7b918e2349", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 66z" }, { "entityid" null, "operationuid" "9c44c26a 5519 4c8f ac4a 1d7b918e2349", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 19 82z" }, { "entityid" null, "operationuid" "9c44c26a 5519 4c8f ac4a 1d7b918e2349", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 20 16z" }, { "entityid" null, "operationuid" "9c44c26a 5519 4c8f ac4a 1d7b918e2349", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 20 417z" }, { "entityid" null, "operationuid" "9c44c26a 5519 4c8f ac4a 1d7b918e2349", "principal" { "name" "no permissions", "iscustom" true, "type" "role", "id" 10410 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 08 29t23 08 25 9z" }, { "entityid" null, "operationuid" "9c44c26a 5519 4c8f ac4a 1d7b918e2349", "principal" { "name" "roll 1", "iscustom" true, "type" "role", "id" 10470 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 04 293z" }, { "entityid" null, "operationuid" "9c44c26a 5519 4c8f ac4a 1d7b918e2349", "principal" { "name" "roll 2", "iscustom" true, "type" "role", "id" 10471 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 25 703z" }, { "entityid" null, "operationuid" "9c44c26a 5519 4c8f ac4a 1d7b918e2349", "principal" { "name" "no setup", "iscustom" true, "type" "role", "id" 10706 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 07t19 42 05 667z" }, { "entityid" null, "operationuid" "9c44c26a 5519 4c8f ac4a 1d7b918e2349", "principal" { "name" "matty boom", "iscustom" true, "type" "role", "id" 10714 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 09t17 11 57 69z" }, { "entityid" null, "operationuid" "9c44c26a 5519 4c8f ac4a 1d7b918e2349", "principal" { "name" "live feed", "iscustom" true, "type" "role", "id" 10795 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 12 11t22 09 07 977z" } ] }, { "uid" "54d5cf37 1ff0 45ff a459 8a5f468a47e1", "singularname" "unassign web page", "pluralname" "unassign web page", "fullname" "web page (full control) unassign web page", "targetentity" "webpage", "appliance" "instance, collection", "parent" { "uid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "singularname" "full control", "pluralname" "web page (full control)", "fullname" "web page (full control)", "targetentity" "webpage", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "54d5cf37 1ff0 45ff a459 8a5f468a47e1", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 44z" }, { "entityid" null, "operationuid" "54d5cf37 1ff0 45ff a459 8a5f468a47e1", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 54z" }, { "entityid" null, "operationuid" "54d5cf37 1ff0 45ff a459 8a5f468a47e1", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 66z" }, { "entityid" null, "operationuid" "54d5cf37 1ff0 45ff a459 8a5f468a47e1", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 19 82z" }, { "entityid" null, "operationuid" "54d5cf37 1ff0 45ff a459 8a5f468a47e1", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 20 16z" }, { "entityid" null, "operationuid" "54d5cf37 1ff0 45ff a459 8a5f468a47e1", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 20 417z" }, { "entityid" null, "operationuid" "54d5cf37 1ff0 45ff a459 8a5f468a47e1", "principal" { "name" "no permissions", "iscustom" true, "type" "role", "id" 10410 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 08 29t23 08 25 9z" }, { "entityid" null, "operationuid" "54d5cf37 1ff0 45ff a459 8a5f468a47e1", "principal" { "name" "roll 1", "iscustom" true, "type" "role", "id" 10470 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 04 293z" }, { "entityid" null, "operationuid" "54d5cf37 1ff0 45ff a459 8a5f468a47e1", "principal" { "name" "roll 2", "iscustom" true, "type" "role", "id" 10471 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 25 703z" }, { "entityid" null, "operationuid" "54d5cf37 1ff0 45ff a459 8a5f468a47e1", "principal" { "name" "no setup", "iscustom" true, "type" "role", "id" 10706 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 07t19 42 05 667z" }, { "entityid" null, "operationuid" "54d5cf37 1ff0 45ff a459 8a5f468a47e1", "principal" { "name" "matty boom", "iscustom" true, "type" "role", "id" 10714 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 09t17 11 57 69z" }, { "entityid" null, "operationuid" "54d5cf37 1ff0 45ff a459 8a5f468a47e1", "principal" { "name" "live feed", "iscustom" true, "type" "role", "id" 10795 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 12 11t22 09 07 977z" } ] }, { "uid" "e69387ad 1517 4266 a745 2fe982da2f16", "singularname" "edit permissions", "pluralname" "edit permissions", "fullname" "web page (full control) edit permissions", "targetentity" "webpage", "appliance" "collection", "parent" { "uid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "singularname" "full control", "pluralname" "web page (full control)", "fullname" "web page (full control)", "targetentity" "webpage", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "e69387ad 1517 4266 a745 2fe982da2f16", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 44z" }, { "entityid" null, "operationuid" "e69387ad 1517 4266 a745 2fe982da2f16", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 54z" }, { "entityid" null, "operationuid" "e69387ad 1517 4266 a745 2fe982da2f16", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 66z" }, { "entityid" null, "operationuid" "e69387ad 1517 4266 a745 2fe982da2f16", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 19 82z" }, { "entityid" null, "operationuid" "e69387ad 1517 4266 a745 2fe982da2f16", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 20 16z" }, { "entityid" null, "operationuid" "e69387ad 1517 4266 a745 2fe982da2f16", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 20 417z" }, { "entityid" null, "operationuid" "e69387ad 1517 4266 a745 2fe982da2f16", "principal" { "name" "no permissions", "iscustom" true, "type" "role", "id" 10410 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 08 29t23 08 25 9z" }, { "entityid" null, "operationuid" "e69387ad 1517 4266 a745 2fe982da2f16", "principal" { "name" "roll 1", "iscustom" true, "type" "role", "id" 10470 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 04 293z" }, { "entityid" null, "operationuid" "e69387ad 1517 4266 a745 2fe982da2f16", "principal" { "name" "roll 2", "iscustom" true, "type" "role", "id" 10471 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 25 703z" }, { "entityid" null, "operationuid" "e69387ad 1517 4266 a745 2fe982da2f16", "principal" { "name" "no setup", "iscustom" true, "type" "role", "id" 10706 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 07t19 42 05 667z" }, { "entityid" null, "operationuid" "e69387ad 1517 4266 a745 2fe982da2f16", "principal" { "name" "matty boom", "iscustom" true, "type" "role", "id" 10714 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 09t17 11 57 69z" }, { "entityid" null, "operationuid" "e69387ad 1517 4266 a745 2fe982da2f16", "principal" { "name" "live feed", "iscustom" true, "type" "role", "id" 10795 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 12 11t22 09 07 977z" } ] }, { "uid" "0d0a10ce 022a 4534 81e4 861d14cc2d79", "singularname" "delete web page", "pluralname" "delete web page", "fullname" "web page (full control) delete web page", "targetentity" "webpage", "appliance" "instance, collection", "parent" { "uid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "singularname" "full control", "pluralname" "web page (full control)", "fullname" "web page (full control)", "targetentity" "webpage", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "0d0a10ce 022a 4534 81e4 861d14cc2d79", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2022 06 21t05 03 20 163z" }, { "entityid" null, "operationuid" "0d0a10ce 022a 4534 81e4 861d14cc2d79", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 44z" }, { "entityid" null, "operationuid" "0d0a10ce 022a 4534 81e4 861d14cc2d79", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 54z" }, { "entityid" null, "operationuid" "0d0a10ce 022a 4534 81e4 861d14cc2d79", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2022 06 21t05 03 19 66z" }, { "entityid" null, "operationuid" "0d0a10ce 022a 4534 81e4 861d14cc2d79", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 19 82z" }, { "entityid" null, "operationuid" "0d0a10ce 022a 4534 81e4 861d14cc2d79", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2022 06 21t05 03 20 417z" }, { "entityid" null, "operationuid" "0d0a10ce 022a 4534 81e4 861d14cc2d79", "principal" { "name" "no permissions", "iscustom" true, "type" "role", "id" 10410 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 08 29t23 08 25 9z" }, { "entityid" null, "operationuid" "0d0a10ce 022a 4534 81e4 861d14cc2d79", "principal" { "name" "roll 1", "iscustom" true, "type" "role", "id" 10470 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 04 293z" }, { "entityid" null, "operationuid" "0d0a10ce 022a 4534 81e4 861d14cc2d79", "principal" { "name" "roll 2", "iscustom" true, "type" "role", "id" 10471 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 09 01t14 45 25 703z" }, { "entityid" null, "operationuid" "0d0a10ce 022a 4534 81e4 861d14cc2d79", "principal" { "name" "no setup", "iscustom" true, "type" "role", "id" 10706 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 07t19 42 05 667z" }, { "entityid" null, "operationuid" "0d0a10ce 022a 4534 81e4 861d14cc2d79", "principal" { "name" "matty boom", "iscustom" true, "type" "role", "id" 10714 }, "isfixed" false, "isinherited" true, "isallowed" true, "creationdate" "2023 11 09t17 11 57 69z" }, { "entityid" null, "operationuid" "0d0a10ce 022a 4534 81e4 861d14cc2d79", "principal" { "name" "live feed", "iscustom" true, "type" "role", "id" 10795 }, "isfixed" false, "isinherited" true, "isallowed" false, "creationdate" "2023 12 11t22 09 07 977z" } ] } ], "permissions" \[ { "entityid" null, "operationuid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2022 06 21t05 03 19 44z" }, { "entityid" null, "operationuid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2022 06 21t05 03 19 54z" }, { "entityid" null, "operationuid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2022 06 21t05 03 19 66z" }, { "entityid" null, "operationuid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2022 06 21t05 03 19 82z" }, { "entityid" null, "operationuid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2022 06 21t05 03 20 16z" }, { "entityid" null, "operationuid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2022 06 21t05 03 20 417z" }, { "entityid" null, "operationuid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "principal" { "name" "no permissions", "iscustom" true, "type" "role", "id" 10410 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "2023 08 29t23 08 25 9z" }, { "entityid" null, "operationuid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "principal" { "name" "roll 1", "iscustom" true, "type" "role", "id" 10470 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2023 09 01t14 45 04 293z" }, { "entityid" null, "operationuid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "principal" { "name" "roll 2", "iscustom" true, "type" "role", "id" 10471 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2023 09 01t14 45 25 703z" }, { "entityid" null, "operationuid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "principal" { "name" "no setup", "iscustom" true, "type" "role", "id" 10706 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2023 11 07t19 42 05 667z" }, { "entityid" null, "operationuid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "principal" { "name" "matty boom", "iscustom" true, "type" "role", "id" 10714 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2023 11 09t17 11 57 69z" }, { "entityid" null, "operationuid" "5555a658 fcf0 4a1a 9044 4512d2d4a6fc", "principal" { "name" "live feed", "iscustom" true, "type" "role", "id" 10795 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "2023 12 11t22 09 07 977z" } ] } failure response 300 300 the requested representation could not be returned because it is ambiguous (there are multiple requested representations) 400 400 the request is malformed and therefore invalid 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 406 406 the server cannot return the data representation that you requested (as specified in the "accept" header) 5xx 5xx any 500 code is an internal server error get /{id\ int}/permissions/ includes object permissions for a given webpage instance required scope token bsn api main webpages retrieve segment id int int a unique identifier for the webpage request example the example request parameters and headers are set as follows id is set to 12345 get /2022/06/rest/webpages/12345/permissions/ 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 success response body 200 200 returns an array of permission entity (2022/06) docid\ jwfymc42cdrg5jy2skysu entities example \[ { "entityid" 12345, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "custom", "iscustom" true, "type" "role", "id" 10000 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2024 01 23t19 39 26 157z" } ] failure response 300 300 the requested representation could not be returned because it is ambiguous (there are multiple requested representations) 400 400 the request is malformed and therefore invalid 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 404 404 the server cannot find the requested resource (the path does not exist) 406 406 the server cannot return the data representation that you requested (as specified in the "accept" header) 5xx 5xx any 500 code is an internal server error post /{id\ int}/permissions/ adds permissions for a webpage on a network required scope token bsn api main webpages update segment id int int a unique identifier for the webpage request body an array of permission entity (2022/06) docid\ jwfymc42cdrg5jy2skysu entities request example the example request parameters and headers are set as follows id is set to 12345 post /2022/06/rest/webpages/12345/permissions/ 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 476 this is the example request body \[ { "entityid" 12345, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "custom", "iscustom" true, "type" "role", "id" 10000 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2024 01 24t16 36 28 663z" } ] success response 204 204 the permissions were successfully added to the specified webpage failure response 400 400 the request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 404 404 the server cannot find the requested resource (the path does not exist) 415 415 the server cannot accept the data representation that you sent (as specified in the "content type" header) 5xx 5xx any 500 code is an internal server error delete /{id\ int}/permissions/ removes permissions from a webpage on a network required scope token bsn api main webpages delete segment id int int a unique identifier for the webpage request body an array of permission entity (2022/06) docid\ jwfymc42cdrg5jy2skysu entities request example the example request parameters and headers are set as follows id is set to 12345 delete /2022/06/rest/webpages/12345/permissions/ 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 476 this is the example request body \[ { "entityid" 12345, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "custom", "iscustom" true, "type" "role", "id" 10000 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2024 01 24t16 36 28 663z" } ] success response 204 204 the specified permissions were successfully deleted failure response 300 300 the requested representation could not be returned because it is ambiguous (there are multiple requested representations) 400 400 the request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 404 404 the server cannot find the requested resource (the path does not exist) 406 406 the server cannot return the data representation that you requested (as specified in the "accept" header) 5xx 5xx any 500 code is an internal server error get /{name}/permissions/ includes object permissions for a given webpage instance required scope token bsn api main webpages retrieve segment name string string a unique identifier for the webpage request example the example request parameters and headers are set as follows name is set to presentationbsdatetimewidget get /2022/06/rest/webpages/presentationbsdatetimewidget/permissions/ 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 success response body 200 200 returns an array of permission entity (2022/06) docid\ jwfymc42cdrg5jy2skysu entities example \[ { "entityid" 12345, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "custom", "iscustom" true, "type" "role", "id" 10000 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2024 01 23t19 39 26 157z" } ] failure response 300 300 the requested representation could not be returned because it is ambiguous (there are multiple requested representations) 400 400 the request is malformed and therefore invalid 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 404 404 the server cannot find the requested resource (the path does not exist) 406 406 the server cannot return the data representation that you requested (as specified in the "accept" header) 5xx 5xx any 500 code is an internal server error post /{name}/permissions/ adds permissions for a webpage on a network required scope token bsn api main webpages update segment name string string a unique identifier for the webpage request body an array of permission entity (2022/06) docid\ jwfymc42cdrg5jy2skysu entities request example the example request parameters and headers are set as follows name is set to presentationbsdatetimewidget post /2022/06/rest/webpages/presentationbsdatetimewidget/permissions/ 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 476 this is the example request body \[ { "entityid" 12345, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "custom", "iscustom" true, "type" "role", "id" 10000 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2024 01 24t16 36 28 663z" } ] success response 204 204 the permissions were successfully added to the specified webpage failure response 400 400 the request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 404 404 the server cannot find the requested resource (the path does not exist) 415 415 the server cannot accept the data representation that you sent (as specified in the "content type" header) 5xx 5xx any 500 code is an internal server error delete /{name}/permissions/ removes permissions from a webpage on a network required scope token bsn api main webpages update segment name string string a unique identifier for the webpage request body an array of permission entity (2022/06) docid\ jwfymc42cdrg5jy2skysu entities request example the example request parameters and headers are set as follows name is set to presentationbsdatetimewidget delete /2022/06/rest/webpages/presentationbsdatetimewidget/permissions/ 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 476 this is an example request body \[ { "entityid" 12345, "operationuid" "0a565477 e461 4b86 b74f 3cc0d98c28f6", "principal" { "name" "custom", "iscustom" true, "type" "role", "id" 10000 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2024 01 24t16 36 28 663z" } ] success response 204 204 the specified permissions were successfully deleted failure response 300 300 the requested representation could not be returned because it is ambiguous (there are multiple requested representations) 400 400 the request or request body is malformed and therefore invalid, or it is rejected in accordance with the business rules 401 401 the access token is invalid or not specified 403 403 the supplied access token, though valid, doesn't provide access to this method 404 404 the server cannot find the requested resource (the path does not exist) 406 406 the server cannot return the data representation that you requested (as specified in the "accept" header) 5xx 5xx any 500 code is an internal server error