Editing photo or video properties
Added by IBM contributorIBM | Edited by Claudia R Elbourn on July 23, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Modify the properties associated with a photo or video.

Update the Atom document representation of the metadata for a file from your library.

This method replaces the content of the elements in the Atom document with the values you specify in the Atom document you provide as input. You may retrieve the property definitions associated with the photo or video's CMIS object type by using the information associated with Retrieving CMIS Object Type properties.

You can use the following header.


Method URI Description
POST /files/{auth}/cmis/repository/{repositoryId}/object/{objectId} Updates the Atom document containing the metadata of a photo or video from your library.
You can determine the URI in either of the following ways:
Value of the href attribute of the element in the file's Document Atom entries.
Construct the URI using the following syntax: {filesServiceUrl}/files/form/cmis/repository/{repositoryId}/object/{objectId}
Note: Atom elements take precedence over HTTP parameters.
Content Type: application/atom+xml
Name Type Optional Description
string No Object ID. By default the Media Gallery provides and uses a "Social Photo" object type with a CMIS id of "ada30772-31fe-44bf-b8b4-dd7e4f072cd6" and a "Social Video" object type with a CMIS id of "ada30772-31fe-44bf-b8b4-dd7e4f072ad6".
string No ID of the repository containing the media content
enumerated No The authorization protocol being used by your application to access Connections Cloud.
Authorized values:
  • basic
  • oauth
Name Type Optional Description
string Yes String. Use the value "PUT". Tunnels a PUT request over the HTTP POST request.
string Yes String. See Retrieving Nonce and User id for how to retrieve the nonce value.
enumerated No The authentication mechanism selected by your application to access the API.
Basic is the Base64 encoding of the IBM Connections Cloud username and password: Base64(username:password). For example, Base64(twatson@us.ibm.com:password).
Bearer is the oauth 2.0 access token that is generated when the user grants your application access to IBM Connections Cloud services.
See the reference topic "OAuth 2.0 APIs for web server flow" for more information.
Authorized values:
  • bearer
  • basic
Content Type: application/atom+xml
Code Description
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.
Add to one collection by POST of atom entry. Note: "category" elements are for tags. Create a "category" element for each tag that should be on the content
<?xml version="1.0" encoding="UTF-8"?>

<entry xmlns="http://www.w3.org/2005/Atom">

    <title>file name</title>


    <category term="tag1" />

    <object xmlns="http://docs.oasis-open.org/ns/cmis/restatom/200908/">

        <properties xmlns="http://docs.oasis-open.org/ns/cmis/core/200908/">

            <propertyString localName="cmis:baseTypeId"




            <propertyString localName="cmis:contentStreamFileName"


                <value>file name</value>


            <propertyString localName="cmis:name"


                <value>file name</value>


            <propertyString localName="cmis:objectTypeId"


                <value>property template cmis objectType id</value>


            <propertyId localName="cmis:objectId"


                <value>document objectId