Delete entity record

Changed on

<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, subject to row-level security.

The record stops appearing in List entity records and Get entity record straight away. Base44 keeps it in the entity's trash rather than erasing it, so you can bring it back with Restore entity record or erase it with Permanently delete entity record.

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

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

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/{entity_id}
  • Auth: HTTP bearer

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. Don't pass User here. It doesn't fail, but it reads and writes a separate, disconnected set of records stored under that name, not the app's real user accounts, which are managed through their own endpoints.

Response

The record was deleted.

successboolean required

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

Example response

{
  "success": true
}

Changes