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

Delete the entity's records first. An entity that still has records can't be removed, and the call changes nothing.

This changes the app's live data model, so it takes effect immediately. It doesn't change the file that defines that model in the app's source code. Since Base44 rebuilds the live model whenever the file is written or the app's code is pulled from GitHub, a change made using this endpoint may be reverted.

To change the model for good, change the entities configuration files.

Pass `User` as the `entity_name` to drop the custom fields from the built-in user entity. Unlike every other entity, this isn't blocked by existing records and it doesn't delete any app users. Their custom values stay in storage but stop being part of the user schema.

## 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 to work with.

## Response `200`

Successful Response

- DeleteEntitySchemaResponse — Confirmation that an entity was removed from the app.
  - `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.
- `428` — The entity still has records. Delete them first.

---

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