Edit or delete reCAPTCHA keys

This page explains how to edit or delete reCAPTCHA keys (also known as keys).

Before you begin

Ensure that you have the following Identity and Access Management role: reCAPTCHA Enterprise Admin (roles/recaptchaenterprise.admin).

The simplest way to edit or delete a reCAPTCHA key is through the Google Cloud console. Alternatively, you can use the reCAPTCHA Enterprise API or the Google Cloud CLI.

Edit a reCAPTCHA key

You can edit only some attributes of a reCAPTCHA key. You cannot change the platform type of a reCAPTCHA key. For example, if a reCAPTCHA key was created for a website, you cannot change the platform type to Android or iOS.

Console

  1. In the Google Cloud console, go to the reCAPTCHA Enterprise page.

    Go to reCAPTCHA Enterprise

    The reCAPTCHA Enterprise page has two views: Tables and Cards. If your project has many reCAPTCHA keys, only the Table view is available.

  2. Verify that the name of your project appears in the resource selector at the top of the page.

    If you don't see the name of your project, click the resource selector, then select your project.

  3. In the Enterprise keys section, identify the reCAPTCHA key you want to edit.

  4. For the reCAPTCHA key, click View key actions and then select Edit key.

  5. On the Edit the reCAPTCHA key page, edit the required fields, and click Update key.

gcloud

To edit reCAPTCHA keys, use the gcloud recaptcha keys update command.

REST API

To edit reCAPTCHA keys, use the projects.keys.patch method.

Delete a reCAPTCHA key

If you delete a reCAPTCHA key from an active integration of reCAPTCHA Enterprise, the website or the mobile application can show errors to your users, and the reCAPTCHA Enterprise API calls return errors.

After you delete reCAPTCHA keys, you cannot recover them.

Console

  1. In the Google Cloud console, go to the reCAPTCHA Enterprise page.

    Go to reCAPTCHA Enterprise

    The reCAPTCHA Enterprise page has two views: Tables and Cards. If your project has many reCAPTCHA keys, only the Table view is available.

  2. Verify that the name of your project appears in the resource selector at the top of the page.

    If you don't see the name of your project, click the resource selector, then select your project.

  3. In the Enterprise keys section, identify the reCAPTCHA key you want to delete.

  4. For the reCAPTCHA key, click View key actions and then select Delete key.

  5. In the confirmation dialog, enter DELETE and click Delete.

gcloud

To edit reCAPTCHA keys, use the gcloud recaptcha keys delete command.

REST API

To edit reCAPTCHA keys, use the projects.keys.delete method.