레퍼런스HTTP APIWorkspace settings

Let Slack guests call agents, or stop them (owner or admin)

POST
/v1/workspaces/{id}/slack-guest

Off by default. While off, a Slack guest (is_restricted) who calls an agent is refused with guest_disabled; while on, a guest still has to link their Slack account. Slack Connect users from other organizations are refused either way. An app with Slack's agent features on is closed to guests by Slack itself. The current value is workspace.settings.slack_guest_enabled in GET /v1/auth/me.

Auth: cookie session only; no scope. Idempotency-Key: ignored.

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

Header Parameters

X-Requested-With?"werft-web"

Required with a cookie session: the literal werft-web.

Value in"werft-web"

Request Body

application/json
  1. body
slack_guest_enabled*boolean

Response Body

Success

application/json
  1. response
slack_guest_enabled*boolean
Example Request
curl -X POST 'https://example.com/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/slack-guest' \  -H 'Content-Type: application/json' \  -d '{  "slack_guest_enabled": true}'
Example Response
{  "slack_guest_enabled": true}