# Delete Secret

`DELETE /vault/secrets/{path}` · Keys & Secrets · Secrets

Revokes a secret at once: it can no longer be read or revealed. Its key material is destroyed when the retention window ends. Only the owner can delete a secret.

## Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `projectId` | query | yes | The project's id. Example: `"3f2c9a4e-8b1d-4c6f-9e2a-7d5b1c0a4e8f"`. |
| `path` | path | yes | The secret's path: `/`-delimited segments, such as `database/prod/password`. Example: `"database/prod/password"`. |

## Responses

- **204**: The secret is revoked.

## Errors

| HTTP | Description |
|---|---|
| 401 | The request carries no authenticated caller. |
| 403 | The caller can see the secret but doesn't own it. |
| 404 | No such secret visible to the caller. |
| 500 | An internal error. Retry later. |

## Code samples

### cURL

```bash
curl -X DELETE 'https://<org>.api-<region>.k9o.io/@storefront/vault/secrets/<name>' \
  -H 'Authorization: Bearer $K9O_TOKEN'
```

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/@storefront/vault/secrets/<name>', {
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer ${process.env.K9O_TOKEN}`
  },
});
const { data, meta } = await res.json();
```

### k9o CLI

```bash
k9o vault-secret delete <name> --region <region>
```

### @k9o/core

```typescript
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data } = await k9o.kibo.vault.secrets.delete('<name>')
```


Canonical page: https://docs.kilimanjaro.dev/api-playground/keys-secrets/delete-secret
