> ## 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 app
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Moves the specified app to the trash. The live app goes offline right away and stops appearing in [List apps](/api-reference/list-apps).
You can delete an app you own. A workspace admin can delete any app in the workspace, and the owner is notified when they do. An editor who doesn't own the app can't delete it.
The app stays in the trash for 30 days. Restore it from Recently deleted in the Base44 dashboard within that window, because the API has no restore endpoint yet.
Restoring the app doesn't reconnect the resources this delete releases, such as its custom domains and OAuth connections. Read `deleted_resources` in the response to see what to set up again.
Pause the app's Google Ads campaigns before you delete it. While one is still serving, the delete is rejected rather than left spending on an app that's gone.
The whole teardown runs before you get a response, so the call takes longer on an app with many connected resources. Retrying is safe. Deleting an app that's already in the trash returns that app and changes nothing.
A delete that fails partway leaves the app live, so check the app before you retry. Some of its connected resources can already be released by then.
The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json delete /api/apps/{app_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}:
delete:
summary: Delete app
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
Moves the specified app to the trash. The live app goes offline right
away and stops appearing in [List apps](/api-reference/list-apps).
You can delete an app you own. A workspace admin can delete any app in
the workspace, and the owner is notified when they do. An editor who
doesn't own the app can't delete it.
The app stays in the trash for 30 days. Restore it from Recently deleted
in the Base44 dashboard within that window, because the API has no
restore endpoint yet.
Restoring the app doesn't reconnect the resources this delete
releases, such as its custom domains and OAuth connections. Read
`deleted_resources` in the response to see what to set up
again.
Pause the app's Google Ads campaigns before you delete it. While one is
still serving, the delete is rejected rather than left spending on an
app that's gone.
The whole teardown runs before you get a response, so the call takes
longer on an app with many connected resources. Retrying is safe.
Deleting an app that's already in the trash returns that app and changes
nothing.
A delete that fails partway leaves the app live, so check the app before
you retry. Some of its connected resources can already be released by
then.
The response includes fields beyond the ones documented here.
Don't rely on undocumented response fields, as they can change at any
time.
operationId: api_delete_api_apps__app_id__delete
parameters:
- name: app_id
in: path
required: true
schema:
type: string
description: ID of the app to delete.
title: App Id
description: ID of the app to delete.
example: 6820f3a4e7b91d003c45a1f2
responses:
'200':
description: The deleted app.
content:
application/json:
schema:
$ref: '#/components/schemas/DeletedApp'
'401':
description: Missing or invalid credentials.
'403':
description: >-
You can't delete this app, because you don't have access to it, it
doesn't exist, or you neither own it nor administer its workspace. A
read-only personal access token is refused here too.
'404':
description: >-
The app is outside the workspace your credential is scoped to, or
outside the apps that credential is allowed to reach.
'409':
description: >-
The app still has running ads campaigns to stop first, or it's busy
with another operation.
components:
schemas:
DeletedApp:
properties:
id:
type: string
title: Id
description: ID of the deleted app.
example: 6820f3a4e7b91d003c45a1f2
name:
type: string
title: Name
description: Display name of the deleted app.
example: My CRM
is_deleted:
type: boolean
title: Is Deleted
description: >-
Whether the app is in the trash. Always `true` here, because the
delete succeeded.
example: true
deleted_date:
type: string
format: date-time
title: Deleted Date
description: >-
Time the app moved to the trash, as a UTC timestamp in ISO 8601
format. The 30 day restore window starts here. Deleting an app that
is already in the trash reports the original deletion time.
example: '2026-08-02T14:30:00'
deleted_resources:
items:
type: string
type: array
title: Deleted Resources
description: >-
Kinds of connected resource this delete released for good, which
restoring the app doesn't rebuild. Each value is one of `domains`,
`integrations`, `automations`, `redirects`, `workflows`,
`templates`, `google_ads`, `plaid`, `folders`, `launchpad`,
`agent_blobs`, or `partner_agent`. The list is empty when the app
had none of them.
example:
- domains
- integrations
type: object
required:
- id
- name
- is_deleted
- deleted_date
- deleted_resources
title: DeletedApp
description: The app that moved to the trash.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: api_key
description: Personal API key.
````