How to disable hooks using Bitbucket Command Line Interface

This article explains how to disable a hook in a Bitbucket repository using Command Line Interface (CLI)


  1. Using the disableHook action, a pre-receive or post-receive hook can be disabled from a repository of Bitbucket. 

    --action disableHook --project "PROJ" --repository "repo-1" --hook "Reject Force Push"

    In above CLI action, 

    • --project value refers to Project key, name, or id.

    • --repository value refers to Repository slug, name, or id.
    • --hook value refers to Hook name or key of the form plugin key:hook key.
  2. To check the status of the hook, navigate to Repositories > Repository settings > Hooks. The hook is disabled as shown in the screenshot below:

It is recommended to test this scenario in a non-production environment or run the action with the --simulate parameter to verify the behavior before deploying.