Delete entity record

<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 and 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>

delete/api/apps/{app_id}/entities/{entity_name}/{entity_id}

Path parameters

entity_idstring required

ID of the record, as id in the response of List entity records.

app_idstring required

ID of the app that owns the entity.

entity_namestring required

Name of the entity, exactly as List entity schemas reports it.

Response

The record was deleted.

successboolean required

Always true. A delete that doesn't happen returns an error instead.

Example response

{
  "success": true
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.