HomeAboutSet rights on a collection.

Set rights on a collection.

22Aug2011 Posted by admin

Set access rights on a collection. When you master-slave a collection to another app, then only assets/mediafiles that are also master-slaved can be accessed by the other client application. Also the number of videos values inside the collection will only reflect the number of actual asset that can be accessed in the master-slaved collection. In some cases the master-slaved collection will not show up in search REST calls like /collection, when the master-slaved collection has no accessable assets.

Request URL

/collection/$coll_id/acl [POST]

Request Authorization

This call needs EGA authentication.

Request Parameters

Parameter (Type)DescriptionRequiredDefault valueMax. length
coll_id (ALPHA_NUM)Collection IDRequired-
user_id (ALPHA_NUM)User id, for authorization the changing process.Required-
acl_app[] (APP_ID)Application(s) that access to the collection.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' or 'FALSE'. Whether the existing rules overwritten or not. Default is 'TRUE'. Defining it as 'FALSE', if you want to keep the old rights.Optionaltrue-

Example Request

collection/7jUOpquLUVf5yCaH4dEmXC6f/acl

acl_app = "3"
coll_id = "7jUOpquLUVf5yCaH4dEmXC6f"
user_id = "testuser"

Example Response

 <items>
  <item id="1">
    <acl_app>
      <value>3</value>
      <result>success</result>
      <result_id>601</result_id>
      <result_description></result_description>
    </acl_app>
  </item>
</items>