---
title: "Delete additional entity field"
type: reference
method: POST
path: /rest-api/additional-entity-fields-configuration/delete.do
tag: "Users"
---

# Delete additional entity field

`POST https://YOUR-NETWORK-DOMAIN/rest-api/additional-entity-fields-configuration/delete.do`

Permanently deletes an additional entity field by its ID. If the specified ID is null or does not correspond to an existing field, the operation completes silently with a success response. An action log entry is recorded when a field is actually deleted. This operation cannot be undone. Requires the ADDITIONAL_ENTITIES_FIELDS_CONFIGURATION admin permission.

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `id` | integer | no | `123` | Unique numeric identifier of the additional entity field to delete. If null or not found, the operation succeeds silently. |

## Responses

- `200` — JSON with 'success: true' indicating the field was deleted or did not exist
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error - invalid hash, timestamp, or username
- `403` — Forbidden - user lacks ADDITIONAL_ENTITIES_FIELDS_CONFIGURATION permission

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/additional-entity-fields-configuration/delete.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'id=123'
```

Source: https://epom.com/ad-server/docs/api/users/post-additional-entity-fields-configuration-delete