current_record_get_previous_revision
Use this action to load the previous revision of the record that an automation runs on.
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 Get previous values of 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
Put this action before an action that compares a deal's old and new amount:
{
"type": "current_record_get_previous_revision",
"config": {}
}
Config
This action takes no config. Send an empty object: "config": {}.
Use the previous values in a later action
Later actions read a value of the previous revision with a field reference that has "previous": true. This reference reads the old deal amount:
{ "kind": "variable", "source": "field", "field_id": 601, "field_type": "number", "previous": true, "collection": false, "triggering": false }
To find the field IDs, see App and field IDs.
General behavior
- The schema has no properties and refuses any extra key. Leaving out the
configkey returns400. - The action loads the revision before the current one.
- Without a trigger that has a record, validation reports the broken reason
action_invalid.periodicandwebhook_receivedhave no record.
Requirements
- To add or change this action through the API, your token needs the
automations:editcapability. See Capabilities. - You must administer the workspace that the automation's database app belongs to.
- The automation needs a trigger with a record.