Create Connection

POST/web/v1/workspaces/{workspaceId}/slash/connectionsJWT

Creates a new Slash platform connection within the specified workspace.

Authentication

Requires a valid JWT token with workspace:manage permission. Portal access: system, tenant.

Request Parameters

Name	Type	Required	In	Description
workspaceId	String	Yes	path	Workspace ID.
connectionName	String	Yes	body	Display name for the connection.
partnerEndpoint	String	Yes	body	Partner API endpoint URL.
slashApiBaseUrl	String	Yes	body	Slash platform API base URL.
slashApiKey	String	Yes	body	API key for authenticating with Slash.
slashAccountId	String	Yes	body	Slash account identifier.
slashWebhookSecret	String	Yes	body	Webhook secret for signature verification.
tenantBizId	String	No	body	Tenant business ID. Auto-resolved if omitted.

Success Response

Bad Request400

{
  "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).