Record Count for a Specific Tag

Purpose

To get the total number of records associated with a specific tag.

Request URL

https://recruit.zoho.com/recruit/v2/settings/tags/{tag_id}/actions/records_count

tag_id - The unique ID of the tag

Request Method

GET

Scope

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

Possible operation types
ALL - Full data access
READ - Get records from a module

Parameters

Parameter NameData TypeDescription
configurations (optional)StringSet as true to get all areas where the tag is configured.

Possible Errors

HTTP StatusError CodeReasonResolution
404INVALID_URL_PATTERNThe URL you are trying to access in incorrect.Specify a valid request URL. Refer the Request URL section.
401OAUTH_SCOPE_MISMATCHYour client does not have ZohoCRM.settings.tags.CREATE scope.Create a new client with a valid scope. Refer the Scope section.
403NO_PERMISSION

The user does not have permission to merge tags.

Contact your system administrator.

500INTERNAL_ERROR

An unexpected and unhandled exception occurred in our server.

Reach out to our customer support team at support@zohorecruit.com.

400INVALID_REQUEST_METHOD

The HTTP request method type chosen is invalid.

Specify a valid request method. Refer the Request Method section.
400AUTHORIZATION_FAILEDThe user does not have the permission to merge tags.Contact your system administrator.

Sample Request

Copiedcurl "https://recruit.zoho.com/recruit/v2/settings/tags/100001000000027114/actions/records_count" -
    X POST -
    H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Sample Response

Copied{
    "configured_areas": {
        "workflow_tagActionRecords": {
            "Workflow": {
                "Add_Tags": [{
                    "name": "wfrule",
                    "rules": {
                        "name": "instant actions"
                    },
                    "id": "100001000000027114"
                }]
            }
        },
        "workflowCriteriaRecords": {
            "100001000000027114": [
                "wfrule"
            ]
        }
    },
    "count": "1"
}