Update Workspace PWA Install (v1)

Method & Path

PATCH /api/v1/admin/workspaces/:workspaceId/pwa-install

Description

Enable or disable whether customers can install the storefront as an app (PWA) for a specific workspace.

Backend path: /v1/admin/workspaces/:workspaceId/pwa-install

Authentication

Required: Admin authentication with businesses.manage permission.

Authorization: Bearer <admin_token>

Headers

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

Path Parameters

Parameter	Type	Required	Description
workspaceId	string	Yes	Workspace ID

Request Body

{
  "pwaInstallEnabled": true
}

Field	Type	Required	Description
pwaInstallEnabled	boolean	Yes	true to allow storefront app install, false to disable

Response 200 OK

{
  "message": "Storefront app install enabled for workspace",
  "workspace": {
    "id": "65f1c1a2b3c4d5e6f7a8b902",
    "name": "Clinic One",
    "email": "clinic@example.com",
    "pwaInstallEnabled": true,
    "createdAt": "2025-01-01T00:00:00.000Z",
    "updatedAt": "2025-01-10T00:00:00.000Z"
  }
}

Common Errors

• 400 Bad Request: Invalid workspace ID
• 401 Unauthorized: Missing or invalid admin authentication token
• 403 Forbidden: Insufficient permissions
• 404 Not Found: Workspace not found
• 500 Internal Server Error: Server error