Update Tag

Purpose

To update a specific tag.

Request URL

https://recruit.zoho.com/recruit/v2/settings/tags/{tag_id}?module={module_api_name} 

tag_id - The ID of the tag you wish to update
module_api_name - The API name of the module

Request Method

PUT

Scope

scope=ZohoRecruit.settings.all
(or)
scope=ZohoRecruit.settings.tags.{operation_type}

 
Possible operation types
ALL - Full data access
WRITE - Edit tag data
UPDATE - Update tag data

Parameters

Parameter NameData TypeDescription
module (mandatory)StringSpecify the API name of the module such as Candidates, Contacts, Job Openings, Interviews, etc,.

Sample Request

Copiedcurl "https://recruit.zoho.com/recruit/v2/settings/tags?module=Candidates" -
    X POST -
    H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
    --data - raw '{
"data": [{
    "tags": [{
        "name": "tag_name",
        "color_code": "#F17574"
    }]
}]

Sample Response

Copied{
    "tags": [{
        "code": "SUCCESS",
        "details": {
            "created_time": "2022-01-24T09:48:25+05:30",
            "modified_time": "2023-01-25T17:49:24+05:30",
            "modified_by": {
                "name": "Patricia Boyle",
                "id": "558879000000293009"
            },
            "name": "tag_name",
            "id": "558879000000880003",
            "created_by": {
                "name": "rohith",
                "id": "558879000000293009"
            }
        },
        "message": "tags updated successfully",
        "status": "success"
    }]
}