---
title: "DELETE /api/v4/secrets/{secretName}"
method: DELETE
path: "/api/v4/secrets/{secretName}"
tags: ["Secrets"]
---

# DELETE /api/v4/secrets/{secretName}

`DELETE /api/v4/secrets/{secretName}`

Delete secret

## Path parameters

- `secretName` string, required

## Request body

- object
  - `projectId` string, required — The ID of the project where the secret is located.
  - `environment` string, required — The slug of the environment where the secret is located.
  - `secretPath` string — The path of the secret.
  - `type` 'shared' | 'personal' — The type of the secret to delete.

## Response `200`

Default Response

- union
  - object
    - `secret` object, required
      - `id` string, required
      - `_id` string, required
      - `workspace` string, required
      - `environment` string, required
      - `version` number, required
      - `type` string, required
      - `secretKey` string, required
      - `secretValue` string, required
      - `secretComment` string, required
      - `secretReminderNote` string, nullable
      - `secretReminderRepeatDays` number, nullable
      - `skipMultilineEncoding` boolean, nullable
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `actor` object, nullable
        - `actorId` string, nullable
        - `actorType` string, nullable
        - `name` string, nullable
        - `membershipId` string, nullable
        - `groupId` string, nullable
      - `isRotatedSecret` boolean
      - `rotationId` string, uuid, nullable
      - `secretValueHidden` boolean, required
  - object — When secret protection policy is enabled
    - `approval` object, required
      - `id` string, uuid, required
      - `policyId` string, uuid, required
      - `hasMerged` boolean
      - `status` string
      - `conflicts` unknown
      - `slug` string, required
      - `folderId` string, uuid, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `isReplicated` boolean, nullable
      - `committerUserId` string, uuid, nullable
      - `statusChangedByUserId` string, uuid, nullable
      - `bypassReason` string, nullable
      - `commitMessage` string, nullable

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/infisical/apis/infisical-api.md) · [All operations](https://skmtc.net/infisical/apis/infisical-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/infisical/infisical-api/versions/885aef3e6c11/schema)