1. GroupDocs Cloud Documentation
    2. /
    3. GroupDocs.Metadata Cloud
    4. /
    5. Developer Guide
    6. /
    7. Metadata Opertaions
    8. /
    9. Add Metadata
    10. /
    11. Add Metadata By Possible Tag Name

    Add Metadata By Possible Tag Name

    On this page

    This REST API allows to add metadata properties to the document choosing the right place to add 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 add metadata date and time information in all properties that have particular string phrase in theirs tag names.

    # Get JSON Web Token
curl -v "https://api.groupdocs.cloud/connect/token" \
  -X POST \
  -d "grant_type=client_credentials&client_id=$CLIENT_ID&client_secret=$CLIENT_SECRET" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "Accept: application/json"

# Join several documents into one
curl -v "https://api.groupdocs.cloud/v1.0/metadata/add" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $JWT_TOKEN" \
  -d '{
    "FileInfo": {
        "FilePath": "documents\\input.docx",
        "StorageName": ""
    },
    "Properties": [
        {
            "Value": "02-12-2020 04:41:10",
            "Type": "DateTime",
            "SearchCriteria": {
                "TagOptions": {
                    "PossibleName": "timeprinted"
                }
            }
        }
    ]
}'

    # Get JSON Web Token
curl.exe -v "https://api.groupdocs.cloud/connect/token" `
  -X POST `
  -d "grant_type=client_credentials&client_id=$env:CLIENT_ID&client_secret=$env:CLIENT_SECRET" `
  -H "Content-Type: application/x-www-form-urlencoded" `
  -H "Accept: application/json"

# Join several documents into one
curl.exe -v "https://api.groupdocs.cloud/v1.0/metadata/add" `
  -X POST `
  -H "Content-Type: application/json" `
  -H "Accept: application/json" `
  -H "Authorization: Bearer $env:JWT_TOKEN" `
  -d "{
    'FileInfo': {
        'FilePath': 'documents\\input.docx',
        'StorageName': ''
    },
    'Properties': [
        {
            'Value': '02-12-2020 04:41:10',
            'Type': 'DateTime',
            'SearchCriteria': {
                'TagOptions': {
                    'PossibleName': 'timeprinted'
                }
            }
        }
    ]
}"

    rem Get JSON Web Token
curl -v "https://api.groupdocs.cloud/connect/token" ^
  -X POST ^
  -d "grant_type=client_credentials&client_id=%CLIENT_ID%&client_secret=%CLIENT_SECRET%" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -H "Accept: application/json"

rem Join several documents into one
curl -v "https://api.groupdocs.cloud/v1.0/metadata/add" ^
  -X POST ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json" ^
  -H "Authorization: Bearer %JWT_TOKEN%" ^
  -d "{\"FileInfo\":{\"FilePath\":\"documents\\input.docx\",\"StorageName\":\"\"},\"Properties\":[{\"Value\":\"02-12-2020 04:41:10\",\"Type\":\"DateTime\",\"SearchCriteria\":{\"TagOptions\":{\"PossibleName\":\"timeprinted\"}}}]}"

    {
    "path": "metadata/add_metadata/documents/input_docx/input.docx",
    "url": "https://api.groupdocs.cloud/v1.0/metadata/storage/file/metadata/add_metadata/documents/input_docx/input.docx",
    "addedCount": 1
}

    SDK examples

    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.

    On this page

    © GroupDocs 2001-2025. All Rights Reserved.