Set ACL by XML 📰

The <CIS_ACLList> node

<CIS_ACLList>
<!-- To add role permissions -->
    <ACL>
        <Role Rights="r">Everyone</Role>
        <Role Rights="rw">admin@yourimagendomain.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">admin@yourimagendomain.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">admin@yourimagendomain.com</Role>
               <Role Rights="rd">admin@yourimagendomain.com</Role>
               <Role Rights="rwd">admin@yourimagendomain.com</Role>

               <Role Rights="read" RoleID="0"></Role>
               <Role Rights="readwrite" RoleID="1"/>
               <Role Rights="readDownload" RoleID="0"></Role>
               <Role Rights="readwriteDownload" RoleID="0"></Role>
           
          </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>

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

Where does it go?