---
title: "Delete secret"
method: DELETE
path: "/api/apps/{app_id}/secrets"
---

# Delete secret

`DELETE /api/apps/{app_id}/secrets`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Deletes one secret from the app.

Deleting a secret redeploys the app's backend functions so they stop receiving it. A function that still reads the name gets no value for it, so remove or update that code too.

Deleting is permanent. To use the secret again, set it anew with [Set secret](/api-reference/set-secret).

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app. A read-only key is refused, and workspace API keys are not accepted.</Note>

## Path parameters

- `app_id` string, required — ID of the app to delete the secret from.

## Query parameters

- `secret_name` string, required — Name of the secret to delete, as returned by [List secrets](/api-reference/list-secrets).

## Response `200`

The secret was deleted.

- DeleteSecretResponse — Confirmation that the secret was deleted.
  - `success` boolean, required — Always `true`. A delete that doesn't happen returns an error instead.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have editor access to this app, or your API key is read-only.
- `404` — App not found, or the app has no secret with this name.
- `422` — `secret_name` is missing.

## Changes

- **2026-09-27** `5e69adeb8667` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/base44/apis/base44-app-management-api/changes/api/apps/:app_id/secrets/delete.md)

---

[API](https://skmtc.dev/base44/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/base44/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/base44/apis/base44-app-management-api/revisions/5e69adeb8667?raw)