---
title: "Delete an app"
description: "Takes the app off its suite's address, then marks it deleted."
canonical: "https://gtable.app/docs/builder-api/apps/delete"
updated: "2026-10-05"
---

# Delete an app

`DELETE https://studio.gtable.app/v1/apps/{appId}`

Takes the app off its suite's address, then marks it deleted.

Its object, rows and files are kept for thirty days, apps.deleted lists it and apps.restore brings it back at the same path, and then purged for good: the object's storage, its files, its assistant conversations and its rows in the control plane. Credentials and invite links naming it are revoked and stay revoked. Send the app's name as `confirm`.

Requires the `schema:write` scope. Operation `apps.delete`. MCP tool `apps_delete`. CLI, once published: `gtable apps delete`.

## Path parameters

| Name    | Type   | Required | Description |
| ------- | ------ | -------- | ----------- |
| `appId` | string | yes      |             |

## Query parameters

| Name      | Type   | Required | Description           |
| --------- | ------ | -------- | --------------------- |
| `confirm` | string | no       | Up to 200 characters. |

## Headers

| Name              | Type   | Required | Description                                                                                                                                                                                                                                                        |
| ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Idempotency-Key` | string | no       | Any unique string. Sending the same key with the same request again returns the first response (marked `Idempotency-Replayed: true`) instead of running it twice. Reusing it for a different request is refused with 409. Kept for 24 hours. Up to 255 characters. |