---
title: "/codes/{codeId}"
method: DELETE
path: "/codes/{codeId}"
---

# /codes/{codeId}

`DELETE /codes/{codeId}`

## Request

- Base URL: `https://api.securevan.com/v4`
- URL: `https://api.securevan.com/v4/codes/{codeId}`
- Auth: HTTP basic

Use this endpoint to delete an existing Code. Use with caution as this this action is *irreversible*.

Codes can only be deleted if they are not applied to any Entity in any context in which the Code exists. *NB*: you may not have access to every context in which the Code exists.


If the specified Code does not exist, this endpoint will return an error with HTTP Status Code `404 Not Found`.

If the specified Code does exist but is not deletable, this endpoint will return an error with HTTP Status Code `403 Forbidden`.

If successful, the endpoint responds with HTTP Status Code `204 No Content` and an empty response body.

## Path parameters

- `codeId` integer, required

## Response `204`

204

## Other responses

- `400`: 400
- `403`: 403
- `404`: 404

## Changes

- **2026-11-03** `4f2049fba5af`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ngpvan/apis/van-crm/changes/codes/:codeId/delete.md)

---

[API](https://skmtc.dev/ngpvan/apis/van-crm.md) - [All operations](https://skmtc.dev/ngpvan/apis/van-crm/llms.txt) - [OpenAPI document](https://skmtc.dev/ngpvan/apis/van-crm/revisions/4f2049fba5af?raw)
