Zoho: Update Workflow Rule by ID

← Workflow rules operations · Get started

Operation zoho.updateworkflowrulebyid

Provider route: PUT /crm/v8/settings/automation/workflow_rules/{id}. Alter supplies the connection’s credentials and routing.

Call through Alter

Install @alter-ai/sdk @alter-ai/zoho with npm, or alter-sdk-zoho with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { ZohoIntegration } from "@alter-ai/zoho";

async function execute(input: Parameters<ZohoIntegration["workflowRules"]["updateWorkflowRuleById"]>[0]) {
  const app = new App({ apiKey: process.env.ALTER_API_KEY! });
  try {
    const provider = new ZohoIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
    const call = await provider.workflowRules.updateWorkflowRuleById(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from alter_sdk_zoho import ZohoIntegration

async def execute(arguments):
    async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
        provider = ZohoIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
        call = await provider.workflow_rules.update_workflow_rule_by_id(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: not allowed
path	object	Required within parent	Additional keys: not allowed
path.id	string	Required within parent	Format: string
body	Model	Optional	Expand Update Workflow Rule by ID — request body — body

Referenced models: Update Workflow Rule by ID — request body — body

Response

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

Field	Type	Presence	Description and constraints
$	Model	Root	Expand Update Workflow Rule by ID — response body

Referenced models: Update Workflow Rule by ID — response body

Schemas

93 more schemas are linked from the tables above, on the schema pages.

Update Workflow Rule by ID — response body

Field	Type	Presence	Description and constraints
$	object	Root	Represents the success response returned after creating a workflow rule, containing the result details of the created rule. Additional keys: not allowed
workflow_rules	array	Optional	Represents the array of workflow rule objects returned in the success response. Maximum items: 200
workflow_rules[]	Model	Each item	Expand Update Workflow Rule Execution Order for Module — response body — reorder item

Referenced models: Update Workflow Rule Execution Order for Module — response body — reorder item

Update Workflow Rule by ID — request body — body

Field	Type	Presence	Description and constraints
$	object	Root	Represents the request body wrapper for updating an existing workflow rule. Contains a single-element array with the updated rule configuration. Additional keys: not allowed
workflow_rules	array	Required within parent	The request body must contain a **workflow_rules** array with one object. Maximum items: 1
workflow_rules[]	Model	Each item	Expand Update Workflow Rule by ID — request body — body workflow rules item

Referenced models: Update Workflow Rule by ID — request body — body workflow rules item

Update Workflow Rule Execution Order for Module — response body — reorder item

Field	Type	Presence	Description and constraints
$	object	Root	Represents a single item in a multi-status response array, including a response code, status indicator, message, and optionally the resource details. Additional keys: not allowed
code	string	Optional	Represents the API response code indicating the operation result, such as **SUCCESS** or **INVALID_DATA**. Maximum length: 255
details	Model	Optional	Expand Update Workflow Rule Execution Order for Module — response body — reorder item details
message	string	Optional	Represents the message describing the operation result or error. Known values: workflow created, workflow updated, workflow deleted, WorkFlow Rule deleted successfully, rules reordered successfully, Workflow cloned successfully
status	string	Optional	Represents the response status indicator, such as **success** or **error**. Maximum length: 7

Referenced models: Update Workflow Rule Execution Order for Module — response body — reorder item details

Update Workflow Rule by ID — request body — body workflow rules item

Field	Type	Presence	Description and constraints
$	object	Root	Represents the configuration object for updating an existing workflow rule, including the rule ID and optional fields such as name, trigger, conditions, and lock status. Additional keys: not allowed
conditions	array	Optional	Specify the array of condition objects to update. On update, unspecified conditions are preserved. Conditions with a null ID are added; conditions with an existing ID get replaced; conditions with a **_delete** flag are removed. Maximum items: 20
conditions[]	Model	Each item	Expand Update Workflow Rule by ID — request body — body workflow rules item conditions item
description	string	Optional	Specify the workflow rule description. Maximum length: 1000
execute_when	Model	Optional	Expand Update Workflow Rule by ID — request body — body workflow rules item execute when Defines the conditions under which the workflow rule will be executed. (Required)
id	string	Optional	Represents the unique ID of the workflow rule to update. Required. Maximum length: 30
lock	object	Optional	Specify whether the workflow rule should be locked to prevent editing by other users. Additional keys: not allowed
lock.message	string	Optional	Specify a note or label indicating the reason or context for locking the rule. Format: string
lock.status	boolean	Optional	Specify whether to lock or unlock the workflow rule. Possible values: true - Locks the rule to prevent editing. false - Unlocks the rule. One of: true, false
module	Model	Optional	Expand List Workflow Rules in your Zoho CRM Organization — response body — workflow rules item module
name	string	Optional	Specify the workflow rule name. Required. Maximum length: 100
status	object	Optional	Specify the activation state of the workflow rule. When setting **active** to false, you can optionally delete all associated scheduled actions. Additional keys: not allowed
status.active	boolean	Optional	Specify whether the workflow rule is active or inactive. Possible values: true - The rule is active and executes when triggered. false - The rule is inactive and does not execute.
status.delete_schedule_action	boolean	Optional	Specify whether to delete all scheduled actions associated with the workflow rule when deactivating it. Possible values: true - Delete all scheduled actions when the rule is deactivated. false - Preserve scheduled actions when the rule is deactivated.

Referenced models: Update Workflow Rule by ID — request body — body workflow rules item conditions item, Update Workflow Rule by ID — request body — body workflow rules item execute when, List Workflow Rules in your Zoho CRM Organization — response body — workflow rules item module

Update Workflow Rule Execution Order for Module — response body — reorder item details

Field	Type	Presence	Description and constraints
$	object	Root	Represents the details object within a success response, containing the unique ID of the created or updated resource. Additional keys: not allowed
id	string	Optional	Represents the unique ID of the SuccessResponseDetails within the workflow rule. Maximum length: 255

Update Workflow Rule by ID — request body — body workflow rules item conditions item

Field	Type	Presence	Description and constraints
$	object	Root	Represents a single condition within a workflow rule that defines which records are evaluated and what actions are executed when the criteria are met. Additional keys: not allowed
_delete	null	Optional	Indicates that this condition should be removed from the workflow rule when set in a PUT request. Provide a null value to signal deletion.
criteria_details	Model	Optional	Expand Update Workflow Rule by ID — request body — body workflow rules item conditions item criteria details Record matching criteria for this condition. When provided, criteria_details must be a JSON object and cannot be null. To match all records, pass an object with criteria set to null, but do not set criteria_details itself to null. This field is required for certain trigger types, such as related module triggers like Notes on Leads. The convert action type requires criteria_details.criteria to be a non-null filter object. Omit criteria_details entirely or pass criteria as null to match all records when the trigger does not require specific criteria and no convert action is present.
id	string	Optional	Represents the unique ID of the condition. Auto-generated on creation. Required on PUT to identify which condition to update. Format: int64
instant_actions	Model	Optional	Expand Update Workflow Rule by ID — request body — body workflow rules item conditions item instant actions Actions to execute immediately when the condition is met. At least one of instant_actions or scheduled_actions must be present - returns MANDATORY_NOT_FOUND if both are absent.
scheduled_actions	Model	Optional	Expand Update Workflow Rule by ID — request body — body workflow rules item conditions item scheduled actions Actions to execute after a configured delay. Scheduled actions require both the trigger and the action type to support scheduling.
sequence_number	integer	Required within parent	Represents the execution order of this condition within the workflow rule, starting from one. Must be unique across all conditions in the rule. Format: int32

Referenced models: Update Workflow Rule by ID — request body — body workflow rules item conditions item criteria details, Update Workflow Rule by ID — request body — body workflow rules item conditions item instant actions, Update Workflow Rule by ID — request body — body workflow rules item conditions item scheduled actions

List Workflow Rules in your Zoho CRM Organization — response body — workflow rules item module

Field	Type	Presence	Description and constraints
$	object	Root	Represents a CRM module or field reference using its API name and unique numeric ID. Minimum fields: 1 Additional keys: not allowed
api_name	string	Required within parent	Represents the API name of the module or field, such as **Leads**, **Contacts**, or a custom field API name. Maximum length: 100
id	string	Required within parent	Represents the unique numeric ID of the module or field. Maximum length: 20

Update Workflow Rule by ID — request body — body workflow rules item execute when details, type — Execute When T3 Section Update

Field	Type	Presence	Description and constraints
$	object	Root	Represents the trigger type for section update rules. Availability varies by the target module Additional keys: not allowed
details	Model	Required within parent	Expand List Workflow Rules in your Zoho CRM Organization — response body — workflow rules item execute when details, type details — shared_details_be3cf6ec2c47
type	string	Required within parent	Represents the trigger type for section update rules. Use getWorkflowConfigurations to verify the trigger is available for the target module. One of: section_update, incoming_call_section_update, outgoing_call_section_update, scheduled_call_section_update

Referenced models: List Workflow Rules in your Zoho CRM Organization — response body — workflow rules item execute when details, type details — shared_details_be3cf6ec2c47

Policy, approvals and errors

SDK function policy ID: zoho.updateworkflowrulebyid. Catalog operation: updateWorkflowRuleById. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Official provider source