Set ACL by XML

Update users or groups in an existing record ACL by calling the  PUT imcc/v1/import/record/  API endpoint or by using the XML upload tool

The <CIS_ACLList> node

<CIS_ACLList>
<!-- To add role permissions -->
<ACL>
  <Role Rights="r">Everyone</Role>
      <Role Rights="rw">superadmin@imagenevp.com</Role>
      <Role Rights="read" RoleID="0"></Role>
      <Role Rights="readwrite" RoleID="1"/>
  </ACL>  
<!-- to remove role permissions -->
  <ACL Merge="1">
  <Role RoleID="0" Rights="0"/>
      <Role RoleID="1" Rights="0"/>
</ACL>
</CIS_ACLList>

Where does it go?

The <CIS_ACLList> nodes have been inserted below in an example XML file, highlighted with 

<*******************************************************************************************> 

⚠️Caution: To update a record via XML the record ID must be placed at the top of the XML like so:

  <ImagenRecord Id=’[ID goes here]> 

👩‍🏫Further reference:

Record update with metadata only

Record update with new media

The two ACL nodes cover both the record permissions and the media object permissions independently.

💡Pro Tip: Follow this link to see the full XML reference

<?xml version="1.0" encoding="UTF-8"?>
<Records>
<ImagenRecord>
<Fields>
<Title>Test</Title>
</Fields>
<*******************************************************************************************>
      <CIS_ACLList>
         <!-- To add role permissions -->
         <ACL>
          <Role Rights="r">Everyone</Role>
              <Role Rights="rw">superadmin@imagenevp.com</Role>              
            </ACL>    
            <!-- to remove role permissions -->
            <ACL Merge="1">
                <Role RoleID="0" Rights="0"/>
                <Role RoleID="1" Rights="0"/>
            </ACL>
      </CIS_ACLList>
<*******************************************************************************************>

<MediaObject Version="3" ID="-1" MediaType="Video">
<*******************************************************************************************>
<CIS_ACLList>
    <ACL>
      <!-- To add role permissions -->
        <Role Rights="r">Everyone</Role>
            <Role Rights="rw">superadmin@imagenevp.com</Role>
             <Role Rights="read" RoleID="0"></Role>
             <Role Rights="readwrite" RoleID="1"/>
        </ACL>
        <!-- to remove role permissions -->
        <ACL Merge="1">
        <Role RoleID="0" Rights="0"/>
            <Role RoleID="1" Rights="0"/>
        </ACL>
  </CIS_ACLList>    
<*******************************************************************************************>
<Name></Name> <!-- Name of this media object -->
<MediaElement MediaType="" Index="" ProfileID="nnnn">
<OriginalFile></OriginalFile> <!-- UNC path\url of the original file -->
</MediaElement>
</MediaObject>
</ImagenRecord>
</Records>