# grove.secrets.delete()

Delete an extension/network Keychain value.

## Signature

```ts
grove.secrets.delete(key: string): Promise<null>
```

## Availability

All packaged runtimes with storage.secure, including settings pages. The storage capability for persistent browser data is separate.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `key` | Yes | Nonempty key after trimming surrounding whitespace, at most 200 characters, no control characters. |

## Return value

Resolves to `null` after the Keychain operation succeeds.

## Behavior and errors

The namespace is isolated by extension identifier and grove.info.networkID, not by channel/query. With an empty networkID it coincides with secrets.application; prefer the explicit application namespace in application Roots and settings pages. Deleting a missing key succeeds. Missing grants, invalid keys/values, and Keychain failures reject with Error. Handle failures without logging credentials. Uninstall removes the extension's secret namespaces; these methods do not access Mango's own network passwords.

## Example

```js
try {
  await grove.secrets.delete('service-session')
} catch {
  console.error('Could not remove the service session.')
}
```

See [Storage and settings](storage-and-settings.md).