setAssetPermissions setassetpermissions

Sets the permissions of a single asset by using a permission asset.

Assets inherit the permissions of their parent folder by default. Once you set permissions on an asset, it no longer inherits the permissions of its parent unless you call removeAssetPermissions.

Authorized User Types section-91fafc170c734ed2a77beafda9221768

  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin

Parameters section-e05abbce6453450fb38747101cb5e228

Input (setAssetPermissonsParam)

Name
Type
Required
Description
companyHandle
xsd:string
Yes
The handle to the company that contains the folder you want to work with.
assetHandle
xsd:string
Yes
Folder handle.
permissionArray
types:PermissionsUpdateArray
Yes
Permissions array.

Output (setAssetPermissonsReturn)

The IPS API does not return a response for this operation.

Examples section-38955bc330bb4909b6b06027ef2b143e

This code sample sets permissions on an asset. It contains the company and asset handle, and a permissions array.

Request

<setAssetPermissionsParam xmlns="http://www.scene7.com/IpsApi/xsd">
   <companyHandle>64</companyHandle>
   <assetHandle>97374|1|61046</assetHandle>
   <permissionArray>
      <items>
         <groupHandle>521</groupHandle>
         <permissionType>Read</permissionType>
         <isAllowed>true</isAllowed>
         <isOverride>true</isOverride>
      </items>
   </permissionArray>
</setAssetPermissionsParam>

Response

None.

recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681