---
title: "Delete entity record"
method: DELETE
path: "/api/apps/{app_id}/entities/{entity_name}/{entity_id}"
---

# Delete entity record

`DELETE /api/apps/{app_id}/entities/{entity_name}/{entity_id}`

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

Deletes one record from one of the app's entities.

The record stops appearing in [List entity records](/api-reference/list-entity-records) and [Get entity record](/api-reference/get-entity-record) straight away. Base44 keeps it in the app's trash rather than erasing it, so an editor can restore it from the app's data screen.

Row-level security applies to the lookup, so a record the entity's `rls` delete rule doesn't cover reports 404 rather than 403.

Deleting a record triggers the app's webhooks and any automation or workflow that listens for this entity.

This endpoint is limited to 100 requests every 30 seconds per app.

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

## Path parameters

- `entity_id` string, required — ID of the record, as `id` in the response of [List entity records](/api-reference/list-entity-records).
- `app_id` string, required — ID of the app that owns the entity.
- `entity_name` string, required — Name of the entity, exactly as [List entity schemas](/api-reference/list-entity-schemas) reports it.

## Response `200`

The record was deleted.

- object — Confirmation that a record 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 access to this app, or your API key is read-only.
- `404` — App not found, the app has no entity with this name, or the entity holds no record with this ID that the `rls` delete rule lets you remove.
- `429` — Rate limit exceeded. This endpoint allows 100 requests every 30 seconds per app.

## Changes

- **2026-09-01** `d8572ad3094a` — 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idealspot/base44-app-management-api/revisions/56dc45634956/schema)