リファレンスHTTP APIWorkspace settings
List the Slack apps this console made in the workspace
GET
Every agent app and the account-link app the platform made here and still keeps (creating, created or deleting): the link app first, then agent apps by agent name. Manual apps and ones failed, abandoned or deleted are left out. Each agent app names its agent and whether the agent's bot is installed now. Owners and admins only; API keys are refused.
Auth: cookie session only; no scope.
cookieSessioncookie
__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.
Match
^([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)$Format
uuidThe made apps; secrets only as whether each is stored.
application/json- response
items*array<>curl -X GET 'https://example.com/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/slack/apps'Example Response
{ "items": [ { "slack_app": { "id": "6a1d3e5f-2b4c-4d8e-9f0a-1b2c3d4e5f60", "kind": "agent", "agent_id": "8d2c4f1a-6b3e-4a9d-b7c5-2e1f0a9b8c7d", "state": "created", "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": true, "last4": "c3d4", "updated_at": "2026-10-23T09:00:00Z", "updated_by": null }, "slack_client_secret": { "configured": true, "last4": "e5f6", "updated_at": "2026-10-23T09:00:00Z", "updated_by": null }, "slack_bot_token": { "configured": false, "last4": null, "updated_at": null, "updated_by": null } } }, "agent": { "id": "8d2c4f1a-6b3e-4a9d-b7c5-2e1f0a9b8c7d", "name": "Release notes", "slug": "release-notes", "installed": true } } ]}