younifyd
Menu

Delete a role

Delete a role

DELETE/settings/roles/{role}

Use it in a workflow

  1. Add a step and choose the Zoho CRM connector.
  2. Pick the Delete a role action (under Users).
  3. Fill in the fields below, then reference the result from later steps as {{deleteARole.response.data}}.

Request

Path parameters

roleinteger (int64)required

The unique ID of the role.

Query parameters

transfer_to_idinteger (int64)required

The unique ID of the role to which subordinate records are transferred before the deletion. Refer to the [Get Roles](roles.yaml#$.paths./settings/roles.get) resource for valid values.

Response

Returns 200 with an object. Read it in later steps with {{deleteARole.response.data.<field>}}.

rolesarray<object>

Represents the list containing the role deletion result.

codestringrequired

Represents the result code of the role deletion operation. Possible values: **SUCCESS** - The role deletion succeeded.

One ofSUCCESS

detailsobjectrequired1 fields

Represents additional details about the deleted role.

messagestringrequired

Represents the status message for the role deletion result.

statusstringrequired

Represents the status of the role deletion operation. Possible values: **success** - The role deletion succeeded.

One ofsuccess

json
{
  "roles": [
    {
      "code": "SUCCESS",
      "details": {
        "id": "string"
      },
      "message": "string",
      "status": "success"
    }
  ]
}

Need more? See the Zoho CRM guide for connection setup and behaviour shared by every action.

Delete a role — Zoho CRM — Documentation