> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/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>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json delete /api/apps/{app_id}/entities/{entity_name}/{entity_id}
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - ApiKeyAuth: []
paths:
  /api/apps/{app_id}/entities/{entity_name}/{entity_id}:
    delete:
      summary: Delete entity record
      description: >-
        <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>
      operationId: >-
        delete_entity_api_apps__app_id__entities__entity_name___entity_id__delete
      parameters:
        - name: entity_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the record, as `id` in the response of [List entity
              records](/api-reference/list-entity-records).
            title: Entity Id
          description: >-
            ID of the record, as `id` in the response of [List entity
            records](/api-reference/list-entity-records).
          example: 6886b8d390dc7e2f4a2c91b3
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app that owns the entity.
            title: App Id
          description: ID of the app that owns the entity.
          example: 6820f3a4e7b91d003c45a1f2
        - name: entity_name
          in: path
          required: true
          schema:
            type: string
            description: >-
              Name of the entity, exactly as [List entity
              schemas](/api-reference/list-entity-schemas) reports it.
            title: Entity Name
          description: >-
            Name of the entity, exactly as [List entity
            schemas](/api-reference/list-entity-schemas) reports it.
          example: Invoice
      responses:
        '200':
          description: The record was deleted.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: DeleteEntityRecordResponse
                description: Confirmation that a record was deleted.
                properties:
                  success:
                    description: >-
                      Always `true`. A delete that doesn't happen returns an
                      error instead.
                    example: true
                    title: Success
                    type: boolean
                required:
                  - success
        '401':
          description: Missing or invalid credentials.
        '403':
          description: You don't have access to this app, or your API key is read-only.
        '404':
          description: >-
            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':
          description: >-
            Rate limit exceeded. This endpoint allows 100 requests every 30
            seconds per app.
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: Personal API key.

````