Skip to main content

Issue Storefront Domain SSL Certificate (v1)

Method & Path​

POST /api/v1/workspace/:workspaceId/storefront/domain/:domainId/issue-ssl

Description​

Issue an SSL certificate for a verified domain. This endpoint triggers SSL certificate provisioning via Google Cloud Run.

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 200 OK​

{
  "success": true,
  "message": "SSL certificate issuance initiated",
  "sslStatus": "pending"
}

Common Errors​

400 Bad Request: Domain not verified or SSL already issued

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​

  • Domain must be verified before issuing SSL certificate
  • SSL certificate provisioning can take several minutes
  • After SSL is active, use Activate Domain endpoint to make domain live