Content Endpoints (2022/06)

48 min

this endpoint allows you to manage content files (and content tags) on the network base url for these endpoints https //api bsn cloud/2022/06/rest/content get / returns a list of content files on a network required scope token bsn api main content 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 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 (see filtering and sorting expressions in the main api docid 3l0afyd3xooe ytvfk2vs for more information) 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 content 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 content 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 marker value is set to the \[pagedlist] \[nextmarker] property value from the previous bsn cloud api response pagesize is set to 1 filter is set to \[mediatype] is 'image' and (\[filename] is ' jpg' or \[filename] is ' jpeg') and \[uploaddate] is in the range '2020 07 01' and '2020 08 01' sort is set to \[lastmodifieddate] desc get /2022/06/rest/content/?marker=mjaymc0wny0yn1qxnjoxnjo0ny44mtdaldy0njg2na%3d%3d\&pagesize=1\&sort=%5blastmodifieddate%5d%20desc\&filter=%5bmediatype%5d%20is%20%27image%27%20and%20%28%5bfilename%5d%20is%20%27 jpg%27%20or%20%5bfilename%5d%20is%20%27 jpeg%27%29%20and%20%5buploaddate%5d%20is%20in%20the%20range%20%272020 07 01%27%20and%20%272020 08 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 returns a paged list entity (2022/06) docid\ pwwr0ln3 binngl mr3st of content entity (2022/06) docid\ fkvdcafrx380751m5hbnr entities (generic data type) 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" 123456, "filename" "zoombg jpeg", "physicalpath" "https //bsncloud s3 amazonaws com/bsts/7abaa3f28f5f824d4f0bbd5eec295f13", "virtualpath" "\\\users\\\night\\\\", "thumbpath" "https //bsncloud s3 amazonaws com/bsts/e6f6eea4387fcae58b40be611c8c3017", "mediatype" "image", "filesize" 6534, "filehash" "sha1 79060249fc80g02990175bb4bde4275e6f05f612", "uploaddate" "2020 07 27t16 16 47 817z", "lastmodifieddate" "2020 07 27t16 16 47 817z", "filelastmodifieddate" "2020 07 16t17 34 20 41z", "probedata" "", "metadata" { "widthpx" 275, "heightpx" 183, "colorspace" "srgb", "colordepthbit" 8, "imageformat" "jpeg" }, "dynamicplaylists" \[ { "id" 123, "name" "my dynamic playlist" } ], "livemediafeeds" \[ { "id" 124, "name" "my live media feed" } ], "taggedplaylists" \[ { "id" 125, "name" "my tagged playlist" } ], "presentations" \[ { "id" 126, "name" "my presentation", "type" "presentation", "link" null } ], "tags" { "string \[content] \<location>" "sea coast", "datetime \[content] \<timetaken>" "2023 10 10t19 06 00 000z" }, "permissions" \[ { "entityid" 123456, "operationuid" "db3a6287 8d03 51b4 6528 704fac1ab8c9", "principal" { "login" "johndoe\@brightsign biz", "type" "user", "id" 101026 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "2023 10 11t22 07 33 507z" }, { "entityid" 123456, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "name" "custom", "iscustom" true, "type" "role", "id" 10498 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2023 10 11t22 07 33 473z" } ] } ], "totalitemcount" 23, "matchingitemcount" 2, "pagesize" 1, "nextmarker" "wm9vbujhmy5qcgvnldy0njg2na==", "prevmarker" "wm9vbujhmy5qcgvnldy0njg267nb", "istruncated" true, "sortexpression" "\[lastmodifieddate] desc", "filterexpression" "\[filename] contains ' jpeg'" } 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 / removes content files, specified by a filter, from a network this allows you to simultaneously delete one or more content files of the auxiliary , stylesheet , font , text , image , video , and/or audio mediatype folders (virtual paths) cannot be deleted using this method required scope token bsn api main content 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 \[virtualpath] is '\\\shared\\\presentations\\\archive\\\\ ' and \[uploaddate] is before '2020 01 01' delete /2022/06/rest/content/?filter=%5bvirtualpath%5d%20is%20%27%5c%5cshared%5c%5cpresentations%5c%5carchive%5c%5c %27%20and%20%5buploaddate%5d%20is%20before%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 body 200 200 returns the number of affected content files 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 to 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 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 /root/{ virtualpath}/ retrieves a list of content files in the specified virtual directory folder this resource maps to the virtual folder in the content library, accordingly the virtual path is either complete or a partial path to a destination content folder or file required scope token bsn api main content retrieve segment virtualpath string string the location of the content file in the bsn cloud virtual directory query string parameters 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 "\[content] \[filename] asc") 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 content instances exceeds the pagesize pagesize int int optional optional the maximum number of content file instances that can be contained in the response body request example the example request parameters and headers are set as follows virtualpath is set to users/johndoe\@brightsign biz/ get /2022/06/rest/content/root/users/johndoe\@brightsign biz/ 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 content entity (2022/06) docid\ fkvdcafrx380751m5hbnr and content folder entity (2022/06) docid 1uodquoarzrz7x0slw2nk entities 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" 123456, "name" "my images", "virtualpath" "\\\users\\\johndoe\@brightsign biz\\\\", "thumbpath" "https //bsncloud s3 amazonaws com 443/public/icons/100x100/icon folder png", "mediatype" "folder", "creationdate" "2020 07 09t19 09 05 103z", "lastmodifieddate" "2020 07 09t19 09 05 103z", "hassubfolders" false, "hasfiles" false, "permissions" \[] }, { "id" 1234567, "name" "my incoming", "virtualpath" "\\\users\\\johndoe\@brightsign biz\\\\", "thumbpath" "https //bsncloud s3 amazonaws com 443/public/icons/100x100/icon folder incoming png", "mediatype" "folder", "creationdate" "2020 07 09t19 09 05 067z", "lastmodifieddate" "2020 07 09t19 09 05 067z", "hassubfolders" false, "hasfiles" false, "permissions" \[] }, { "id" 12345678, "name" "my videos", "virtualpath" "\\\users\\\johndoe\@brightsign biz\\\\", "thumbpath" "https //bsncloud s3 amazonaws com 443/public/icons/100x100/icon folder png", "mediatype" "folder", "creationdate" "2020 07 09t19 09 05 143z", "lastmodifieddate" "2020 07 09t19 09 05 143z", "hassubfolders" false, "hasfiles" false, "permissions" \[] } ], "totalitemcount" 3, "matchingitemcount" 3, "pagesize" 100, "nextmarker" "ldywmjg0nw==", "prevmarker" "ldywmjg089nh", "istruncated" false, "sortexpression" "\[content] \[filename] asc", "filterexpression" "\[type] in ('image', 'video', 'audio', 'folder') and \[virtualpath] = \\\users\\\johndoe\@brightsign biz\\\\" } 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 /root/{ virtualpath}/ creates a content folder in the specified virtual directory folder and returns the url link to the folder location this resource maps to the virtual folder in the content library, accordingly the virtual path is either complete or a partial path to a destination content folder or file required scope token bsn api main content create segment virtualpath string string optional optional the location of the content instance in the bsn cloud virtual directory request body the content folder entity (2022/06) docid 1uodquoarzrz7x0slw2nk request example the example request parameters and headers are set as follows virtualpath is set to /users/johndoe\@brightsign biz/ post /2022/06/rest/content/root/users/johndoe\@brightsign biz/ 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 95 this is the example request body { "id" 0, "name" "testing", "virtualpath" "\\\users\\\johndoe\@brightsign biz\\\\", "thumbpath" "", "mediatype" "folder", "creationdate" "0001 01 01t00 00 00", "lastmodifieddate" "0001 01 01t00 00 00", "hassubfolders" false, "hasfiles" false, "permissions" \[] } success response body 201 201 returns the new resource created and referenced by the uri (given by the location header field) in the response the response includes the content folder entity (2022/06) docid 1uodquoarzrz7x0slw2nk example { "id" 123456, "name" "testing", "virtualpath" "\\\users\\\johndoe\@brightsign biz\\\\", "thumbpath" "", "mediatype" "folder", "creationdate" "2023 06 07t19 00 08 156z", "lastmodifieddate" "2023 06 07t19 00 08 156z", "hassubfolders" false, "hasfiles" false, "permissions" \[] } 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 to 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) 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 get /count/ retrieves the number of content files on the network matching the specified filter criteria if no filter is included, this call returns the total number of content files on the network required scope token bsn api main content retrieve query string parameter filter string string optional optional 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 \[filename] contains ' jpeg' get /2022/06/rest/content/count/?filter=%5bfilename%5d%20contains%20%27 jpeg%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 content file 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}/ retrieves the specified content file required scope token bsn api main content retrieve segment id int int a unique identifier for the content instance this value is generated by the server when the content file is uploaded query string parameters these parameters should only be used when requesting an image (they depend on the representation type) maxwidth ushort ushort optional optional the maximum width of the content instance (this should equal 100) maxheight ushort ushort optional optional the maximum height of the content instance (this should equal 100) request examples this example request returns json metadata the parameters and headers are set as follows (since the header specifies application/json , the maxwidth and maxheight parameters are not needed) id is set to 123456 the optional if modified since header value equals the last modified header value retrieved from the get /id response get /2022/06/rest/content/123456/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} if modified since fri, 08 dec 2023 16 34 43 gmt accept encoding gzip,deflate accept application/json, application/vnd bsn error+json this example request returns an image file the parameters and headers are set as follows id is set to 123456 maxwidth is set to 100 maxheight is set to 100 get /2022/06/rest/content/123456/?maxwidth=100\&maxheight=100 http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept encoding gzip,deflate accept image/png, image/jpeg, image/gif success response with body 200 200 returns either the content entity (2022/06) docid\ fkvdcafrx380751m5hbnr or the file associated with the requested content, depending on what is specified in the request example this is an example of a 200 level response { "id" 123456, "filename" "zoombg jpeg", "physicalpath" "https //bsncloud s3 amazonaws com/bsts/7abaa3f28f5f824d4f0bbd5eec295f13", "virtualpath" "\\\users\\\night\\\\", "thumbpath" "https //bsncloud s3 amazonaws com/bsts/e6f6eea4387fcae58b40be611c8c3017", "mediatype" "image", "filesize" 6534, "filehash" "sha1 79060849fc80f02990175bb4bde4375e6f05f622", "uploaddate" "2020 07 27t16 16 47 817z", "lastmodifieddate" "2023 12 08t16 34 44 093z", "filelastmodifieddate" "2020 07 27t16 16 47 817z", "probedata" "", "metadata" { "widthpx" 275, "heightpx" 183, "colorspace" "srgb", "colordepthbit" 8, "imageformat" "jpeg" }, "dynamicplaylists" \[ { "id" 123, "name" "my dynamic playlist" } ], "livemediafeeds" \[ { "id" 124, "name" "my live media feed" } ], "taggedplaylists" \[ { "id" 125, "name" "my tagged playlist" } ], "presentations" \[ { "id" 126, "name" "my presentation", "type" "presentation", "link" null } ], "tags" { "string \[content] \<location>" "sea coast", "datetime \[content] \<timetaken>" "2023 10 10t19 06 00 000z" }, "permissions" \[ { "entityid" 123456, "operationuid" "db3a6287 8d03 51b4 6528 704fac1ab8c9", "principal" { "login" "johndoe\@brightsign biz", "type" "user", "id" 101026 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "2023 10 11t22 07 33 507z" }, { "entityid" 123456, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "name" "custom", "iscustom" true, "type" "role", "id" 10498 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "2023 10 11t22 07 33 473z" } ] } 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 put /{id\ int}/ update the specified content files required scope token bsn api main content update segment id int int a unique identifier for the content instance this value is generated by the server when the content file is uploaded request body the content entity (2022/06) docid\ fkvdcafrx380751m5hbnr request example the example request parameters and headers are set as follows id is 123456 the optional if unmodified since header value equals the last modified header value retrieved from the get /id response put /2022/06/rest/content/123456/ 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 if unmodified since wed, 20 dec 2023 21 32 34 gmt content type application/json content length 861 this is the example request body { "id" 0, "filename" "display jpeg", "physicalpath" null, "virtualpath" "\\\users\\\night\\\\", "thumbpath" null, "mediatype" "image", "filesize" 0, "filehash" null, "uploaddate" "0001 01 01t00 00 00", "lastmodifieddate" "0001 01 01t00 00 00", "filelastmodifieddate" "0001 01 01t00 00 00", "probedata" null, "metadata" null, "dynamicplaylists" null, "livemediafeeds" null, "taggedplaylists" null, "presentations" null, "tags" {}, "permissions" \[] } success response 204 204 the specified content file has been updated on the network 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 to 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 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) 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 patch /{id\ int}/ applies a sequence of changes to a specific content entity specified by id see rfc 6902 https //datatracker ietf org/doc/html/rfc6902 required scope token bsn api main content regular update segment id int int a unique identifier for the content instance this value is generated by the server when the content file is uploaded request body these properties are entries in an array every entry must have all three of these properties op string string the type of operation in this case it is always "replace" path string string a uri path that references the location within the target document where the update will be performed value object object the replacement value(s) for the parameters that must be updated this can be an array request example the example request parameters and headers are set as follows id is 12345 patch /2022/06/rest/content/12345/ 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 patch+json content length 1068 this is the example request body \[ { "op" "replace", "path" "/virtualpath/", "value" "\\\shared\\\incoming\\\\" }, { "op" "replace", "path" "/tags/", "value" { "string \[content] \<string>" "helloworld", "boolean \[content] \<boolean>" true, "number \[content] \<number>" 42, "datetime \[content] \<datetime>" "2024 01 12t22 00 00 123z", "numericarray \[content] \<numericarray>" "1, 2, 3", "stringarray \[content] \<stringarray>" "\\"a\\", \\"b\\", \\"c\\"" } }, { "op" "replace", "path" "/permissions/", "value" \[ { "entityid" 12345, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "name" "my custom role", "iscustom" true, "type" "role", "id" 54321 }, "isfixed" false, "isinherited" false, "isallowed" true, "creationdate" "0001 01 01t00 00 00" } ] } ] success response 204 204 the parameters have been successfully replaced 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) 412 412 precondition failed (the resource changed since the time specified in the “if unmodified since” header value) 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}/ this method allows you to delete files that are of the auxiliary , stylesheet , font , text , image , video , and/or audio mediatype , as well as empty and non empty folders which contain files that are not currently used required scope token bsn api main content delete segment id int int a unique identifier for the content instance to delete request example the example request parameters and headers are set as follows id is set to 123456 the optional if unmodified since header value equals the last modified header value retrieved from the get /id response delete /2022/06/rest/content/123456/ 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 content file has been removed 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 to 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) 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 /{id\ int}/tags/ returns tags associated with the specified content file required scope token bsn api main content retrieve segment id int int a unique identifier for the content file this value is generated by the server when the content file is uploaded request example the example request parameters and headers are set as follows id is set to 123456 get /2022/06/rest/content/123456/tags/ 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 list of properties and their values example { "string \[content] \<anon>" "image", "number \[content] \<billingrate>" "30" } 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}/tags/ adds one or more tags to the specified content file the following are valid system defined values for content tags "filename", "filesize", "contenttype", and "uploaddate" required scope token bsn api main content update segment id int int a unique identifier for the content instance this value is generated by the server when the content file is uploaded request body tags dynamicobject dynamicobject a collection of key value pairs where the key is tag name, and the value is tag value see the tags entry in player entity (2022/06) docid 9pqprrjavwfzbka1gybea for more information request example the example request parameters and headers are set as follows id is set to 123456 a tag is added to set the billing rate to 30 post 2022/06/rest/content/123456/tags/ 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 34 this is the example request body { 	"\[content] \<billingrate>" 30 } success response 204 204 a new tag has been successfully added to the specified content file failure response 400 400 either a tag with the specified key was already defined, the request is malformed and therefore invalid, or there is a conflict 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}/tags/ removes one or more tags from the specified content file required scope token bsn api main content update segment id int int a unique identifier for the content instance this value is generated by the server when the content file is uploaded request body list list\<string> list\<string> a list of key/value pairs that specify the tags to delete from the content file request example the example request parameters and headers are set as follows id is set to 123456 the "string \[content] \<anon>" tag will be deleted delete /2022/06/rest/content/123456/tags/ 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 28 this is the example request body \[ "string \[content] \<anon>" ] success response 204 204 the specified tags have been removed from the specified content file 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 to 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) 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/content/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 origin http //localhost/ success response body 200 200 returns the business operations entity (2022/06) docid\ ei98k7oul6z5i 5b d6js example expand { "uid" "39e69897 8d9a f634 95cf 7419a3e93c23", "singularname" "full control", "pluralname" "content (full control)", "fullname" "content (full control)", "targetentity" "content", "appliance" "instance, collection", "parent" null, "descendants" \[ { "uid" "db3a6287 8d03 51b4 6528 704fac1ab8c9", "singularname" "view content", "pluralname" "view content", "fullname" "content (full control) view content", "targetentity" "content", "appliance" "instance, collection", "parent" { "uid" "39e69897 8d9a f634 95cf 7419a3e93c23", "singularname" "full control", "pluralname" "content (full control)", "fullname" "content (full control)", "targetentity" "content", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "db3a6287 8d03 51b4 6528 704fac1ab8c9", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2020 08 17t20 49 47 14z" }, { "entityid" null, "operationuid" "db3a6287 8d03 51b4 6528 704fac1ab8c9", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2020 08 17t20 49 47 663z" }, { "entityid" null, "operationuid" "db3a6287 8d03 51b4 6528 704fac1ab8c9", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 45 817z" }, { "entityid" null, "operationuid" "db3a6287 8d03 51b4 6528 704fac1ab8c9", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 077z" }, { "entityid" null, "operationuid" "db3a6287 8d03 51b4 6528 704fac1ab8c9", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 39z" }, { "entityid" null, "operationuid" "db3a6287 8d03 51b4 6528 704fac1ab8c9", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 46 68z" } ] }, { "uid" "d61ef4ac 4da7 5f34 d9ba 6fc152313e26", "singularname" "upload content", "pluralname" "upload content", "fullname" "content (full control) upload content", "targetentity" "content", "appliance" "collection", "parent" { "uid" "39e69897 8d9a f634 95cf 7419a3e93c23", "singularname" "full control", "pluralname" "content (full control)", "fullname" "content (full control)", "targetentity" "content", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "d61ef4ac 4da7 5f34 d9ba 6fc152313e26", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2020 08 17t20 49 46 69z" }, { "entityid" null, "operationuid" "d61ef4ac 4da7 5f34 d9ba 6fc152313e26", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 45 817z" }, { "entityid" null, "operationuid" "d61ef4ac 4da7 5f34 d9ba 6fc152313e26", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 077z" }, { "entityid" null, "operationuid" "d61ef4ac 4da7 5f34 d9ba 6fc152313e26", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 39z" }, { "entityid" null, "operationuid" "d61ef4ac 4da7 5f34 d9ba 6fc152313e26", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 47 127z" }, { "entityid" null, "operationuid" "d61ef4ac 4da7 5f34 d9ba 6fc152313e26", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 47 65z" } ] }, { "uid" "5e5354dc 5ef6 4d9e a832 a8f1014c85ad", "singularname" "update content", "pluralname" "update content", "fullname" "content (full control) update content", "targetentity" "content", "appliance" "instance, collection", "parent" { "uid" "39e69897 8d9a f634 95cf 7419a3e93c23", "singularname" "full control", "pluralname" "content (full control)", "fullname" "content (full control)", "targetentity" "content", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "5e5354dc 5ef6 4d9e a832 a8f1014c85ad", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 45 817z" }, { "entityid" null, "operationuid" "5e5354dc 5ef6 4d9e a832 a8f1014c85ad", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 077z" }, { "entityid" null, "operationuid" "5e5354dc 5ef6 4d9e a832 a8f1014c85ad", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 39z" }, { "entityid" null, "operationuid" "5e5354dc 5ef6 4d9e a832 a8f1014c85ad", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 46 68z" }, { "entityid" null, "operationuid" "5e5354dc 5ef6 4d9e a832 a8f1014c85ad", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 47 127z" }, { "entityid" null, "operationuid" "5e5354dc 5ef6 4d9e a832 a8f1014c85ad", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 47 65z" } ] }, { "uid" "ff7314eb 8094 42c7 8d86 9741d29ce7f1", "singularname" "manage tags", "pluralname" "manage tags", "fullname" "content (full control) manage tags", "targetentity" "content", "appliance" "instance, collection", "parent" { "uid" "39e69897 8d9a f634 95cf 7419a3e93c23", "singularname" "full control", "pluralname" "content (full control)", "fullname" "content (full control)", "targetentity" "content", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "ff7314eb 8094 42c7 8d86 9741d29ce7f1", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 45 817z" }, { "entityid" null, "operationuid" "ff7314eb 8094 42c7 8d86 9741d29ce7f1", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 077z" }, { "entityid" null, "operationuid" "ff7314eb 8094 42c7 8d86 9741d29ce7f1", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 39z" }, { "entityid" null, "operationuid" "ff7314eb 8094 42c7 8d86 9741d29ce7f1", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 46 68z" }, { "entityid" null, "operationuid" "ff7314eb 8094 42c7 8d86 9741d29ce7f1", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 47 127z" }, { "entityid" null, "operationuid" "ff7314eb 8094 42c7 8d86 9741d29ce7f1", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 47 65z" } ] }, { "uid" "8cba3c2c c3ab 4b50 970d 6d6382a05856", "singularname" "assign content", "pluralname" "assign content", "fullname" "content (full control) assign content", "targetentity" "content", "appliance" "instance, collection", "parent" { "uid" "39e69897 8d9a f634 95cf 7419a3e93c23", "singularname" "full control", "pluralname" "content (full control)", "fullname" "content (full control)", "targetentity" "content", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "8cba3c2c c3ab 4b50 970d 6d6382a05856", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 45 817z" }, { "entityid" null, "operationuid" "8cba3c2c c3ab 4b50 970d 6d6382a05856", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 077z" }, { "entityid" null, "operationuid" "8cba3c2c c3ab 4b50 970d 6d6382a05856", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 39z" }, { "entityid" null, "operationuid" "8cba3c2c c3ab 4b50 970d 6d6382a05856", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 46 68z" }, { "entityid" null, "operationuid" "8cba3c2c c3ab 4b50 970d 6d6382a05856", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 47 127z" }, { "entityid" null, "operationuid" "8cba3c2c c3ab 4b50 970d 6d6382a05856", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 47 65z" } ] }, { "uid" "2080cb7c 813a 4e9f 90c4 2af213d78d88", "singularname" "unassign content", "pluralname" "unassign content", "fullname" "content (full control) unassign content", "targetentity" "content", "appliance" "instance, collection", "parent" { "uid" "39e69897 8d9a f634 95cf 7419a3e93c23", "singularname" "full control", "pluralname" "content (full control)", "fullname" "content (full control)", "targetentity" "content", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "2080cb7c 813a 4e9f 90c4 2af213d78d88", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 45 817z" }, { "entityid" null, "operationuid" "2080cb7c 813a 4e9f 90c4 2af213d78d88", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 077z" }, { "entityid" null, "operationuid" "2080cb7c 813a 4e9f 90c4 2af213d78d88", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 39z" }, { "entityid" null, "operationuid" "2080cb7c 813a 4e9f 90c4 2af213d78d88", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 46 68z" }, { "entityid" null, "operationuid" "2080cb7c 813a 4e9f 90c4 2af213d78d88", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 47 127z" }, { "entityid" null, "operationuid" "2080cb7c 813a 4e9f 90c4 2af213d78d88", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 47 65z" } ] }, { "uid" "9cfe2e6c bb4f 404e b94e 54d4d705b299", "singularname" "edit permissions", "pluralname" "edit permissions", "fullname" "content (full control) edit permissions", "targetentity" "content", "appliance" "collection", "parent" { "uid" "39e69897 8d9a f634 95cf 7419a3e93c23", "singularname" "full control", "pluralname" "content (full control)", "fullname" "content (full control)", "targetentity" "content", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "9cfe2e6c bb4f 404e b94e 54d4d705b299", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 45 817z" }, { "entityid" null, "operationuid" "9cfe2e6c bb4f 404e b94e 54d4d705b299", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 077z" }, { "entityid" null, "operationuid" "9cfe2e6c bb4f 404e b94e 54d4d705b299", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 39z" }, { "entityid" null, "operationuid" "9cfe2e6c bb4f 404e b94e 54d4d705b299", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 46 68z" }, { "entityid" null, "operationuid" "9cfe2e6c bb4f 404e b94e 54d4d705b299", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 47 127z" }, { "entityid" null, "operationuid" "9cfe2e6c bb4f 404e b94e 54d4d705b299", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 47 65z" } ] }, { "uid" "1aab37d3 1540 9c34 b116 62090419488e", "singularname" "delete content", "pluralname" "delete content", "fullname" "content (full control) delete content", "targetentity" "content", "appliance" "instance, collection", "parent" { "uid" "39e69897 8d9a f634 95cf 7419a3e93c23", "singularname" "full control", "pluralname" "content (full control)", "fullname" "content (full control)", "targetentity" "content", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "1aab37d3 1540 9c34 b116 62090419488e", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2020 08 17t20 49 47 15z" }, { "entityid" null, "operationuid" "1aab37d3 1540 9c34 b116 62090419488e", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 45 817z" }, { "entityid" null, "operationuid" "1aab37d3 1540 9c34 b116 62090419488e", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 077z" }, { "entityid" null, "operationuid" "1aab37d3 1540 9c34 b116 62090419488e", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2020 08 17t20 49 46 39z" }, { "entityid" null, "operationuid" "1aab37d3 1540 9c34 b116 62090419488e", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 46 68z" }, { "entityid" null, "operationuid" "1aab37d3 1540 9c34 b116 62090419488e", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2020 08 17t20 49 47 65z" } ] } ], "permissions" \[ { "entityid" null, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2020 08 17t20 49 45 817z" }, { "entityid" null, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2020 08 17t20 49 46 077z" }, { "entityid" null, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2020 08 17t20 49 46 39z" }, { "entityid" null, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2020 08 17t20 49 46 68z" }, { "entityid" null, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2020 08 17t20 49 47 127z" }, { "entityid" null, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2020 08 17t20 49 47 65z" } ] } 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/ returns object permissions for a given content instance required scope token bsn api main content retrieve segment id int int a unique identifier for the content instance this value is generated by the server when the content file is uploaded request example the example request parameters and headers are set as follows id is set to 1234567 get /2022/06/rest/content/1234567/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" 1234567, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "login" "johndoe\@brightsign biz", "type" "user", "id" 101026 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2023 09 08t17 15 36 013z" } ] 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 to the specified content instance required scope token bsn api main content update segment id int int a unique identifier for the content instance this value is generated by the server when the content file is uploaded 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/content/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 313 this is the example request body \[ { "entityid" 12345, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "login" "johndoe\@brightsign biz", "type" "user", "id" 101026 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "0001 01 01t00 00 00" }, { "entityid" 12345, "operationuid" "ff7314eb 8094 42c7 8d86 9741d29ce7f1", "principal" { "name" "custom", "iscustom" true, "type" "role", "id" 10498 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "0001 01 01t00 00 00" } ] success response 204 204 the permissions were successfully added to the specified content instance failure response 400 400 the request or request body is malformed and therefore invalid, or it is rejected in accordance to 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 the specified content file required scope token bsn api main content update segment id int int a unique identifier for the content file this value is generated by the server when the content file is uploaded 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/content/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 313 this is the example request body \[ { "entityid" 12345, "operationuid" "39e69897 8d9a f634 95cf 7419a3e93c23", "principal" { "login" "johndoe\@brightsign biz", "type" "user", "id" 101026 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "0001 01 01t00 00 00" }, { "entityid" 12345, "operationuid" "ff7314eb 8094 42c7 8d86 9741d29ce7f1", "principal" { "name" "custom", "iscustom" true, "type" "role", "id" 10498 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "0001 01 01t00 00 00" } ] success response 204 204 the specified permissions have been removed from the specified content file 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 to 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