레퍼런스HTTP APIWorkspace settings

List the Slack apps this console made in the workspace

GET
/v1/workspaces/{id}/slack/apps

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.

Authorization

cookieSession
cookie__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.

Path Parameters

id*string

The 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)$
Formatuuid

Response Body

The made apps; secrets only as whether each is stored.

application/json
  1. response
items*array<>
Example Request
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      }    }  ]}