HomeAboutSet rights on multiple mediafiles.

Set rights on multiple mediafiles.

22Aug2011 Posted by admin

Set rights on multiple mediafiles using asset ids.

Request URL

/mediafile/acl [POST]

Request Authorization

This call needs EGA authentication.

Request Parameters

Parameter (Type)DescriptionRequiredDefault valueMax. length
asset_id[] (ALPHA_NUM)The asset IDs of mediafiles which to change the rights.Required-
user_id (ALPHA_NUM)Must match the owner fo the mediafile.Required-
acl_app[] (INT)Application(s) that gain access to the mediafile.Optional-
acl_domain[] (STRING)Domain(s) that gain access to the mediafile.Optional-
acl_group[] (ALPHA_NUM)Group(s) that gain access to the mediafile.Optional-
acl_group_id[] (ALPHA_NUM)Alias of acl_group.Optional-
acl_realm[] (STRING)Realm(s) that gain access to the mediafile.Optional-
acl_user[] (ALPHA_NUM)User(s) that gain access to the mediafile.Optional-
acl_user_id[] (ALPHA_NUM)Alias of acl_user.Optional-
mediamosa_version (MEDIAMOSA_VERSION)Provide the version to get the REST call returned in the format of the specified MediaMosa version. Keep empty or skip to retrieve in current (latest) version. Provide '2' to retrieve the REST call in 2.x format. Or be more specific by providing up to 3 digits; '2.3.0'. This setting will override any setting used by client application or the default setting in MediaMosa.Optional-
replace (BOOL)'TRUE' of 'FALSE' if the current right has to be replaced. Standard is TRUE. Define if 'FALSE' if you want to keep the old rights.OptionalTRUE-

Example Request

mediafile/acl asset_id[]=7pAkDsceysAZPo0q3PhjtBE1&asset_id[]=J2MKUJUcleMUfUcsZVDpdxi8

Example Response

<items>
  <item id="1">
    <acl_user>
      <asset_id>7pAkDsceysAZPo0q3PhjtBE1</asset_id>
      <mediafile_id>VxsIJXDjuYUJKq81n9Ulimmu</mediafile_id>
      <value>user1</value>
      <result>success</result>
      <result_id>601</result_id>
      <result_description></result_description>
    </acl_user>
  </item>
  <item id="2">
    <acl_user>
      <asset_id>7pAkDsceysAZPo0q3PhjtBE1</asset_id>
      <mediafile_id>OW35AQyoPNUSi4iINunmS2nr</mediafile_id>
      <value>user1</value>
      <result>success</result>
      <result_id>601</result_id>
      <result_description></result_description>
    </acl_user>
  </item>
  <item id="3">
    <acl_user>
      <asset_id>J2MKUJUcleMUfUcsZVDpdxi8</asset_id>
      <mediafile_id>lH8hZUCQmjAUWXIYWnXioHHF</mediafile_id>
      <value>user1</value>
      <result>success</result>
      <result_id>601</result_id>
      <result_description></result_description>
    </acl_user>
  </item>
</items>