Skip to content

Delete Stripe Connection

POST/web/v1/workspaces/{workspaceId}/stripe/connections/deleteJWT

Soft-deletes a Stripe connection. The connection will no longer be usable for payment processing or webhook delivery.

Authentication

Auth Chain: WEB Chain — requires Authorization: Bearer <jwt> Requires workspace:manage permission. These headers are injected by the system (frontend does nothing): X-PORTAL-ACCESS-CODE (Nginx), X-Request-Id (Gateway)

Request Parameters

NameTypeRequiredInDescription
workspaceIdstringYespathWorkspace business ID
connectionBizIdstringYesbodyBusiness ID of the connection to delete

Success Response

Success200
{
  "version": "1.3.0",
  "timestamp": 1709337600000,
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": "Stripe connection deleted"
}

Error Responses

Unauthorized401
{
  "success": false,
  "code": "4010",
  "message": "Invalid or expired token"
}
Not Found404
{
  "success": false,
  "code": "4040",
  "message": "Stripe tenant connection not found"
}

Notes

  • This is a soft-delete operation; the record is marked as deleted but not physically removed.
  • Deleted connections cannot be reactivated.
  • Requires the workspace:manage permission on the target workspace.

Internal Documentation