PermuteDocs
Go to Permute

Apps · appsDelete

Delete an app

Requests asynchronous deletion of the hosted app. Poll get until the app returns 404. Requires admin permission.

DELETE/v1/apps/{applicationId}
betaapiKeyworkspace

When to use

Delete an app and its hosted deployment.

For agents

Requires app admin permission. Deletion is asynchronous: poll get until the app returns 404. A failed deployment needs administrator recovery.

Example

typescript
import { PermuteClient } from '@permute/sdk';

const orgClient = new PermuteClient({
  apiKey: process.env.PERMUTE_API_KEY!,
});

const client = orgClient.withWorkspace(process.env.PERMUTE_WORKSPACE_ID!);

const result = await client.apps.delete('appl_abcdefghijklmnopqrstuvwx');

Response

json
{
  "data": {
    "id": "appl_abcdefghijklmnopqrstuvwx",
    "deleted": false
  }
}