---
title: "Delete entity schema"
method: DELETE
path: "/api/apps/{app_id}/entity-schemas/{entity_name}"
---

# Delete entity schema

`DELETE /api/apps/{app_id}/entity-schemas/{entity_name}`

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

Removes an entity from the app.

The entity has to be empty first. A delete on an entity that still has records returns a 428 and changes nothing, so delete its records before calling this.

<Warning>This changes the app's live schema right away, but it does not change the entity definition in the app's source code. Base44 rebuilds the live schema from the source files whenever the app's code changes, which reverts anything you set here. Change the code itself when you need the edit to last.</Warning>

Pass `User` as the `entity_name` to drop the custom fields from the built-in user entity. That does not delete any app users, and it is not blocked by existing records: the custom values stay in storage but stop being part of the user schema.

A name the app does not have returns a 404, except for a workspace API key, which gets a 200 so a repeated deploy is safe.

<Note>This endpoint accepts a personal API key, or a workspace API key with the `apps:deploy` scope.</Note>

## Path parameters

- `entity_name` string, required — Name of the entity to remove, as returned by [List entity schemas](/api-reference/list-entity-schemas). Pass `User` to drop the built-in user entity's custom fields.
- `app_id` string, required — ID of the app whose entity schemas you want.

## Response `200`

The entity schema was removed.

- DeleteEntitySchemaResponse
  - `success` boolean, required — Always `true`. A delete that failed returns an error status instead.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have editor access to this app, or your workspace API key lacks the `apps:deploy` scope.
- `404` — App not found, or the app has no entity with this name (a workspace API key gets a 200 instead).
- `409` — The request is scoped to a feature branch. Entity schemas can only be changed on the main branch.
- `422` — Validation Error
- `428` — The entity still has records. Delete them first.

## Changes

- **2026-08-25** `8dfd9c46c0b9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/apps/:app_id/entity-schemas/:entity_name/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/31ef75eb64ab/schema)