POST /admin/whatsapp/version/refresh

Fetch and apply the latest WhatsApp Web version via whatsmeow. This affects new connections globally.

Query parameters

  • force boolean

    Force refresh even if recently refreshed

    Default value is true.

Responses

  • 200 application/json

    WhatsApp Web version refreshed successfully

    Hide response attributes Show response attributes object
    • status boolean
    • code integer
    • message string
    • data object
      Hide data attributes Show data attributes object
      • refreshed boolean
      • wa_web_version object
        Hide wa_web_version attributes Show wa_web_version attributes object
        • array array[integer]
        • string string
      • last_refreshed string
      • last_error string
  • 401 application/json

    Unauthorized - Invalid admin secret

    Hide response attributes Show response attributes object
    • status boolean
    • code integer
    • message string
    • error string
  • 500 application/json

    Internal server error

    Hide response attributes Show response attributes object
    • status boolean
    • code integer
    • message string
    • error string
POST /admin/whatsapp/version/refresh
curl \
 --request POST 'http://localhost:7001/admin/whatsapp/version/refresh' \
 --header "X-Admin-Secret: $API_KEY"
Response examples (200)
{
  "code": 200,
  "data": {
    "refreshed": true,
    "last_error": "",
    "last_refreshed": "2025-12-21T10:30:00Z",
    "wa_web_version": {
      "array": [
        2,
        3000,
        1012345678
      ],
      "string": "2.3000.1012345678"
    }
  },
  "status": true,
  "message": "WhatsApp Web version refreshed successfully"
}
Response examples (200)
{
  "status": true,
  "code": 200,
  "message": "WhatsApp Web version refreshed successfully",
  "data": {
    "refreshed": true,
    "wa_web_version": {
      "array": [
        2,
        3000,
        1012345678
      ],
      "string": "2.3000.1012345678"
    },
    "last_refreshed": "2025-12-21T10:30:00Z",
    "last_error": "string"
  }
}
Response examples (401)
{
  "status": false,
  "code": 401,
  "message": "Unauthorized",
  "error": "Invalid or missing authentication"
}
Response examples (500)
{
  "status": false,
  "code": 400,
  "message": "Bad request",
  "error": "Bad request"
}