Manage playbook content - Manage playbook content and avoid concurrent playbook editing. - Administrator Guide - Cortex CLOUD

Cortex Cloud Posture Management Documentation

Product
Cortex Cloud Application Security > Cortex CLOUD
License
Cloud Posture Management
Creation date
2025-01-22
Last date published
2026-06-04
Category
Administrator Guide
Abstract

Manage playbook content and avoid concurrent playbook editing.

Save versions of your playbook in Cortex Cloud

You can save versions of a playbook as you are developing it. When you save a version of a playbook, add a meaningful comment so that you will be able to recognize the changes you made in that version at a later time. The version is saved with the name of the playbook, your commit message, an indication of what the change was (modify, insert), the date the playbook was saved, and the name of the author who last saved it. If necessary, you can access the playbook’s version history and revert your playbook to a previous version.

  1. In a playbook, after making changes, click the list next to Save Playbook and then click Save version for current Playbook.

    playbook-save.png
  2. Enter a description of the change that was made to the current version.

  3. Click Update Playbook.

  4. To access a version of a playbook:

    1. Click the icon next to New Playbook. The tooltip displays Version history for all Playbooks.

      playbook-version.png
    2. Search for the required playbook. The description that was entered when the version was saved should help you locate the version you now require.

    3. Click Restore to restore the required version of the playbook.

Playbook editing conflict management

If multiple users simultaneously attempt to edit the same playbook, they could overwrite each other's changes in the playbook editor. To prevent users from accidentally losing their work, the playbook editor only allows the first user to edit and save. Subsequent users are automatically placed in View Mode Only, and a banner in the playbook editor clearly shows who is currently editing the playbook. The subsequent users can still view, debug, run, duplicate, and download the playbook.

Note

Opening a playbook does not immediately lock it. A playbook is considered to be in edit mode only when a user makes a modification that causes the Save button to become available.

The playbook is automatically unlocked when the user currently editing the playbook saves the playbook, closes the editor, logs out, or when their session expires. In addition, users with playbook View/Edit and Unlock permission can click Unlock in the banner on the Playbooks page or directly in the playbook editor to force-unlock the playbook.

Important

Manually unlocking a playbook may cause version conflicts. This turns off concurrent editing protection, and if the original user is still editing, their changes might be lost or overwritten.

The playbook Unlock permission is located under SettingsConfigurationsAccess ManagementRoles. Edit a role and go to Investigation & ResponseAutomationsPlaybooks. Ensure you have View/Edit permissions selected.