Delete one of the workspace's Slack apps in Slack
Deletes the app in Slack (apps.manifest.delete with the config token) and its stored secrets; the row stays as deleted. Only an app recorded in this workspace's Slack apps can be named. An agent's app takes an owner, an admin or that agent's admin; any other app an owner or admin. An app Slack no longer has counts as deleted. One still being created answers 409 SLACK_APP_CREATING. API keys are refused.
Auth: cookie session only; no scope. Idempotency-Key: ignored.
cookieSession__Host-werft_session<token>For the web console: the browser session cookie set by POST /v1/auth/login. It holds the scopes of the user's workspace role (owner: all; admin and member: all but sessions:recover). Requests other than GET must also send X-Requested-With: werft-web.
id*stringThe workspace's id.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidapp_id*stringThe Slack app's id.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidX-Requested-With?"werft-web"Required with a cookie session: the literal werft-web.
"werft-web"Deleted in Slack, or already gone there; the app as now stored, its secrets dropped.
application/json- response
slack_app*curl -X DELETE 'https://example.com/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/slack/apps/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "slack_app": { "id": "6a1d3e5f-2b4c-4d8e-9f0a-1b2c3d4e5f60", "kind": "agent", "agent_id": "8d2c4f1a-6b3e-4a9d-b7c5-2e1f0a9b8c7d", "state": "deleted", "app_id": "A0B1C2D3E4F", "client_id": "1234567890.9876543210", "redirect_url": "https://console.example.ts.net/agents/8d2c4f1a-6b3e-4a9d-b7c5-2e1f0a9b8c7d/slack/callback", "created_by_token_user": "U0ISSUER", "created_at": "2026-10-23T09:00:00Z", "updated_at": "2026-10-23T09:00:00Z", "secrets": { "slack_signing_secret": { "configured": false, "last4": null, "updated_at": null, "updated_by": null }, "slack_client_secret": { "configured": false, "last4": null, "updated_at": null, "updated_by": null }, "slack_bot_token": { "configured": false, "last4": null, "updated_at": null, "updated_by": null } } }}