Create Connection

POST/web/v1/workspaces/{workspaceId}/slash/connections JWT

Creates a new Slash platform connection within the specified workspace.

Required Headers

Header	Example Value	Description
Content-Type	application/json	Request content type
Accept	application/json	Expected response type
X-Client-Hash		Client device fingerprint
Accept-Language	en, zh, zh-Hant, ja, vi	Response language (default: en)
Authorization	Bearer	JWT access token
X-Workspace-Id		Target workspace ID

Request Parameters

Name	Type	Required	In	Description
request	SlashTenantConnectionCreateRequest	Required	body	Raw request body (encrypted via SecureChannel, auto-decrypted by the server)
workspaceId	String	Required	path	Workspace ID.", constraints: "Path parameter (injected by gateway)
connectionName	String	Required	body	Display name for the connection.", constraints: "Must not be blank
partnerEndpoint	String	Required	body	Partner API endpoint URL.", constraints: "Must not be blank
slashApiBaseUrl	String	Required	body	Slash platform API base URL.", constraints: "Must not be blank
slashApiKey	String	Required	body	API key for authenticating with Slash.", constraints: "Must not be blank
slashAccountId	String	Required	body	Slash account identifier.", constraints: "Must not be blank
slashWebhookSecret	String	Required	body	Webhook secret for signature verification.", constraints: "Must not be blank
tenantBizId	String	Optional	body	Tenant business ID. Auto-resolved if omitted.

Success Response

Bad Request 400

{
  "code": "4000",
  "message": "connectionName must not be blank"
}

Error Responses

HTTP Status	Code	Description
400	4000	Validation error (missing required fields)
401	4010	Invalid or expired JWT token
403	4030	Insufficient permissions

Notes

• Returns HTTP 201 on success.
• Sensitive fields (slashApiKey, slashAccountId, slashWebhookSecret) are masked in the response.
• The connection is created in PENDING status (20010201).