BAbase44

List deleted entity records

Changed on

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

Returns the records deleted from one of the app's entities that are still in its trash.

A record lands here when Delete entity record removes it, and stays until you bring it back with Restore entity record or erase it with Permanently delete entity record. Row-level security doesn't apply, so you get every deleted record in the entity. Users removed with Remove app user aren't listed here, so asking for the User entity's trash returns a 404.

Filter and sort the same way as List entity records. Page with skip and limit. The 5000 record cap doesn't apply here, so leave out limit to get the whole trash in one response.

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app, or a workspace API key, which acts as the workspace owner. Read-only keys work too.</Note>

Runs as your user in this app, so the app's access rules decide which records you can read or change.

get/api/apps/{app_id}/entities/{entity_name}/trash

Request

  • Base URL
    https://app.base44.com
  • Auth
    • HTTP bearer
    • or API key in header api_key
    • or HTTP bearer

Path parameters

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.

Query parameters

qstring

Filter as a JSON object of field names and values, for example {"status": "paid"} for an exact match, or using an operator such as $gt for a comparison. See Filtering, sorting, and paging for a full list of operators.

limitinteger

Maximum number of deleted records to return, from 1 to 10000. Leave it out to get every matching deleted record in one response.

skipinteger

Number of deleted records to skip before the ones you get back, 0 or more. Defaults to 0. Use it with limit to page through a long list.

sortstring

Single field to sort by, prefixed with - for descending. For example, -created_date returns newest first. Sorting by more than one field isn't supported.

fieldsstring

Comma-separated list of fields to return, which reduces the response size on a wide entity. Reach a field inside an object with dots, as in customer.email. Each record still carries its id whether you ask for it or not.

Response

The entity's deleted records.

idstring nullable

ID of the record. Pass it as entity_id to Get entity record, Update entity record or Delete entity record.

created_datestring nullable

When the record was created, as a UTC timestamp in ISO 8601 format. A record Base44 has just created carries a Z suffix, and a record read back from storage does not.

updated_datestring nullable

When the record last changed, as a UTC timestamp in ISO 8601 format. A record Base44 has just created carries a Z suffix, and a record read back from storage does not.

created_bystring nullable

Email of the app user who created the record, or anonymous when a visitor created it on an app that needs no login. Apps that hide record authorship leave this field out of the response.

created_by_idstring nullable

ID of the app user who created the record, or anonymous when a visitor created it on an app that needs no login.

is_sampleboolean nullable

Whether Base44 stored the record as sample data while the app was being built. A record you create reports false.

deleted_datestring nullable

When the record was deleted, as a UTC timestamp in ISO 8601 format.

Example response

[
  {
    "id": "6886b8d390dc7e2f4a2c91b3",
    "created_date": "2026-06-01T09:23:41.481000",
    "updated_date": "2026-06-04T14:07:02.115000",
    "created_by": "jane@acme.com",
    "created_by_id": "6874b0c2e1a94d0031bb77de",
    "deleted_date": "2026-06-05T11:42:18.207000"
  }
]

Changes

  • e51af2957a57Revision changes
    • info

      added the non-success response with the status

  • 0ca6a43fceb9Revision changes
    • info

      the endpoint scheme security WorkspaceApiKeyAuth was added to the API

    • info

      the endpoint scheme security WorkspaceApiKeyBearerAuth was added to the API