레퍼런스HTTP APIWorkspace settings

Whether the Slack App Configuration Token is set (owner or admin)

GET
/v1/workspaces/{id}/slack/config-token

Says whether a token is set, its last four characters, when it was last set and by whom, when the current access token expires and which Slack user issued it. state is unset, active, or needs_reentry when Slack no longer takes the stored token or a rotation's answer was lost: paste a new one. The token itself is never returned. urls are the addresses to copy into a Slack app made by hand, computed from the console's public origin (CONSOLE_ORIGIN) and fixed paths: redirect_url for Sign in with Slack and events_url_template with {agent_id} for the agent's id. Each is null when it cannot be computed: no origin, or (events) an origin that is not https. 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 token's state; never its value.

application/json
  1. response
configured*boolean
last4*|null
updated_at*|null
updated_by*|null
urls*
state*string
Value in"unset""active""needs_reentry"
expires_at*|null
issuer*|null
Example Request
curl -X GET 'https://example.com/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/slack/config-token'
Example Response
{  "configured": true,  "last4": "a9f3",  "updated_at": "2026-10-23T09:00:00Z",  "updated_by": {    "user_id": "3e7f1a90-5c2d-4b8e-8f61-2a9d0c4b7e35",    "display_name": "Jae"  },  "urls": {    "redirect_url": "https://werft.example.com/settings/linked-accounts/slack",    "events_url_template": "https://werft.example.com/v1/slack/events/{agent_id}"  },  "state": "active",  "expires_at": "2026-10-23T21:00:00Z",  "issuer": {    "user_id": "U0ISSUER",    "team_id": "T0TEAM"  }}