Skip to main content
Automation API

current_record_delete

Use this action to delete the record that an automation runs on.

Tip

Read the live config shape of each action type from GET /v1/automation/meta/action before you build on it.

In the automation editor, this action is Delete the current record in the Current record family. Its group is action, and it needs a trigger with a record: record_created, record_updated, record_deleted, record_comment_or_reply_created, date_field_arrived, automation_called or weblink_clicked.

Send it in the actions array of Create an automation or Update an automation. An update replaces the whole array, so include the other actions.

Example​

This action deletes the current record with the defaults:

{
"type": "current_record_delete",
"config": {}
}

This action removes a cancelled solar installation request without notifications and attributes the deletion to the user who created the record:

{
"type": "current_record_delete",
"config": {
"author_id": { "kind": "variable", "source": "meta", "meta_type": "created_by", "app_id": 87 },
"silent": true
}
}

Config​

The action has no keys of its own. It takes only the keys that every record-changing action shares.

PropertyTypeDescriptionExample value
author_idinteger | referenceUser Tape attributes the deletion to: a reference to the creator, the last modifier or a user field. Left out, the automation itself is the author.{ "kind": "variable", "source": "meta", "meta_type": "created_by", "app_id": 87 }
trigger_webhooksbooleanWhether the deletion fires outbound webhooks. Default false.false
trigger_other_flowsbooleanWhether the deletion starts other automations. Default false.false
silentbooleanWhether Tape sends no notifications for the deletion. Default false.true

In the action menu of the automation editor, these keys are Author, Trigger webhooks, Trigger automations and Silent.

General behavior​

  • No key is required.
  • The action deletes the record the run works on.
  • Without a trigger that has a record, validation reports the broken reason action_invalid. periodic and webhook_received have no record.
  • Without author_id, the automation itself is the author. Use a reference in author_id: with a literal user ID, validate reports action_user_missing, even for an existing user, and activation fails.
  • Tape returns silent on every read. It's false when you left it out.
  • To bring the record back later in the same run, add current_record_restore.

Requirements​

  • To add or change this action through the API, your token needs the automations:edit capability. See Capabilities.
  • You must administer the workspace that the automation's database app belongs to.
  • The automation needs a trigger with a record.

Next steps​