# Delete

Launch stage: GA

`POST /api/2.0/secrets/scopes/delete`

Deletes a secret scope.

 Example request:

 .. code::

    {
        "scope": "my-secret-scope"
    }

 Throws ``RESOURCE_DOES_NOT_EXIST`` if the scope does not exist.
 Throws ``PERMISSION_DENIED`` if the user does not have permission to make this API call.
 Throws ``BAD_REQUEST`` if system user attempts to delete internal secret scope.

API scopes: secrets

## Request body

- `scope` (string, optional)
  Name of the scope to delete.

## Response

```json
{}
```