Skip to main content

Delete Storefront Domain (v1)

Method & Path​

DELETE /api/v1/workspace/:workspaceId/storefront/domain/:domainId

Description​

Permanently delete a custom domain from a workspace storefront.

Authentication​

Required: Workspace authentication. User must be authenticated as Workspace Owner or Staff with store.manage permission.

Headers​

Authorization: Bearer <workspace_token>
Content-Type: application/json

Path Parameters​

ParameterTypeRequiredDescription
workspaceIdstringYesWorkspace identifier
domainIdstringYesDomain identifier

Response 204 No Content​

No response body.

Common Errors​

401 Unauthorized: Missing or invalid authentication token

403 Forbidden: User does not have store.manage permission

404 Not Found: Workspace or domain not found

500 Internal Server Error: Server error occurred while processing the request

Notes​

  • This operation is permanent and cannot be undone
  • DNS records and SSL certificates are not automatically removed
  • Workspace subscription status is checked before processing the request