Set Metadata By Possible Tag Name


This REST API allows to set document metadata new values choosing properties to edit by approximate or a part of metadata tag name.

This API allows you to specify any part of metadata tag name or tag category name.

cURL Example

The following example demonstrates how to set new metadata creator name.

# First get JSON Web Token
# Please get your App Key and App SID from 
# Kindly place App Key in "client_secret" and App SID in "client_id" argument.
curl -v "" \
-d "grant_type#client_credentials&client_id#xxxx&client_secret#xxxx" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
# cURL example to join several documents into one
curl -v "" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>" \
-d "{
    "FileInfo": {
        "FilePath": "documents\\input.docx",
        "StorageName": ""
    "Properties": [
            "NewValue": "NewAuthor",
            "Type": "String",
            "SearchCriteria": {
                "TagOptions": {
                    "PossibleName": "creator"
    "path": "metadata/add_metadata/documents/input_docx/input.docx",
    "url": "",
    "setCount": 1


Using an SDK (API client) is the quickest way for a developer to speed up the development. An SDK takes care of a lot of low-level details of making requests and handling responses and lets you focus on writing code specific to your particular project. Check out our GitHub repository for a complete list of GroupDocs.Metadata Cloud SDKs along with working examples, to get you started in no time. Please check Available SDKs article to learn how to add an SDK to your project.

Set Metadata By Possible Tag Name