Skip to main content

Update Lucky Wheel (v1)

Method & Path​

PUT /api/v1/public/dollab/manage

Actual path: /v1/public/dollab/manage

Description​

Replaces the shared lucky-wheel items for every visitor. Appearance weights are stored in the database and used only when spinning.

Authentication​

Password in body. Persona: Customer (organizer using Manage). Not Workspace Owner / Staff / Admin auth.

Headers​

  • Content-Type: application/json

Request Body​

{
  "password": "admin123",
  "items": [
    {
      "id": "3f1a0c2e-4b8d-4a91-9c77-1d2e3f4a5b6c",
      "label": "خصم 50%",
      "weight": 10,
      "color": "#f59e0b"
    },
    {
      "label": "هدية مفاجئة",
      "weight": 22,
      "color": "#8b5cf6"
    }
  ]
}

id is optional on new items. Maximum 24 items. color must be #RRGGBB.

Response 200 OK​

{
  "items": [
    {
      "id": "3f1a0c2e-4b8d-4a91-9c77-1d2e3f4a5b6c",
      "label": "خصم 50%",
      "weight": 10,
      "color": "#f59e0b"
    }
  ]
}

Common Errors​

  • 400 Bad Request: Invalid payload
  • 403 Forbidden: Wrong manage password
  • 422 Unprocessable Entity: Invalid label, color, weight, or too many items
  • 500 Internal Server Error: Could not save the wheel