Delete a Slack app
Soft-deletes a Slack app the caller owns: the record is retained for the audit trail and the app id slot is freed for a later re-import.
Soft-deletes a Slack app the caller owns: the record is retained for the audit trail and the app id slot is freed for a later re-import. Existing workspace bindings created through the app keep working — deleting the app record does not disconnect installed workspaces. Returns { "appId": "...", "status": "deleted" }; an app the caller does not own, or one already deleted, is a 404. Requires the inboxes:write scope.
Scope: inboxes:write. Send the API key as a bearer token; Scopes lists what each one reaches.
Request
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
appId | string | yes | The Slack app id (e.g. A012ABCD0A0). |
Response
200 Success. Body: application/json, SlackAppDeleteResponse.
| Field | Type | Required | Description |
|---|---|---|---|
appId | string | yes | |
status | string | yes | 'deleted'. |
Errors
Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.
| Status | Meaning |
|---|---|
400 | The request is malformed or a value is invalid (invalid_request, invalid_domain, idempotency_key_mismatch). |
401 | The API key is missing or invalid. |
403 | The key lacks the scope this endpoint needs (scope_missing) or may not do this (not_permitted). |
404 | No such resource in this account (resource_not_found). |
429 | Rate limit, plan limit, budget or spend cap reached (rate_limited, plan_limit_reached, budget_exceeded, spend_cap_reached). |
500 | An unexpected error; retry with backoff, then contact support (internal_error). |
Update a Slack app's ambient mode
Updates a Slack app's ambientMode, the only mutable field; ambientMode is required in the body and must be off or store.
Mint an install URL for a specific Slack app
Mints a signed https://slack.com/oauth/v2/authorize install URL — the "Add to Slack" button — for the specific app named in the path and returns it as url.