Delete entity record

curl --request DELETE \
  --url https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/{entity_id} \
  --header 'api_key: <api-key>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/{entity_id}"

headers = {"api_key": "<api-key>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/{entity_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/{entity_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/{entity_id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/{entity_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true
}

Entities

Delete entity record

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

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 app’s trash rather than erasing it, so an editor can restore it from the app’s data screen.

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

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.

DELETE

api

apps

{app_id}

entities

{entity_name}

{entity_id}

Delete entity record

curl --request DELETE \
  --url https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/{entity_id} \
  --header 'api_key: <api-key>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/{entity_id}"

headers = {"api_key": "<api-key>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/{entity_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/{entity_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/{entity_id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/entities/{entity_name}/{entity_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

entity_id

string

required

ID of the record, as id in the response of List entity records.

app_id

string

required

ID of the app that owns the entity.

entity_name

string

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.

Confirmation that a record was deleted.

success

boolean

required

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

Example:

true

Base44 APIs

Apps API (Beta)

Monitoring API

Audit Logs API

Delete entity record

Authorizations

Path Parameters

Response