Change a widget's label or config — PATCH /v1/widgets/{widget_id}

`config` is a FULL replacement, validated the same way as on create — a merge would make it impossible to remove an allowed origin or a per-book override, and "send it back with your change in it" is the only rule that has one meaning. The widget id and the embed snippets do not change, so nothing on the customer's page needs redeploying.

Requires X-API-Key 0 credits

Request

curl -X PATCH 'https://api.puntersedge.online/v1/widgets/YOUR_WIDGET_ID' \
  -H 'X-API-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"label": "LABEL", "config": {}}'

Parameters

Name	In	Type	Required	Description
`widget_id`	path	string	yes	wgt_… from POST /v1/widgets.
`label`	body	string	no
`config`	body	object	no	FULL replacement after validation, not a merge — send the whole config back with your change in it, or omit the field to leave the stored one alone.

Responses

Status codes: 200, 401, 402, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.

Example response

200 application/json — this call costs 0 credits. Field names and types are as the API returns them; values are a real sample, trimmed to a few items.

{
  "widget_id": "wgt_3f9a1c74e20b6d58",
  "label": "Form guide sidebar",
  "active": true,
  "created_at": "2026-09-11T05:22:40Z",
  "last_served_at": "2026-09-25T00:03:12Z",
  "fills_total": 48211,
  "config": {
    "bookmakers": [
      "sportsbet",
      "tab",
      "ladbrokes_au"
    ],
    "defaults": {
      "country": "AU",
      "sports": [
        "afl",
        "nrl"
      ]
    },
    "theme": "light"
  },
  "embed": {
    "racing": "<iframe src=\"https://puntersedge.online/widget/v1/wgt_3f9a1c74e20b6d58/racing\" width=\"100%\" height=\"500\" frameborder=\"0\" loading=\"lazy\" title=\"Next to go\"></iframe>",
    "sports": {
      "afl": "<iframe src=\"https://puntersedge.online/widget/v1/wgt_3f9a1c74e20b6d58/afl\" width=\"100%\" height=\"500\" frameborder=\"0\" loading=\"lazy\" title=\"afl\"></iframe>",
      "nrl": "<iframe src=\"https://puntersedge.online/widget/v1/wgt_3f9a1c74e20b6d58/nrl\" width=\"100%\" height=\"500\" frameborder=\"0\" loading=\"lazy\" title=\"nrl\"></iframe>"
    }
  },
  "csp": "frame-src https://puntersedge.online"
}

Related endpoints

GET /v1/account — Your account: email, plan, password, billing and consent status
POST /v1/account/marketing — Turn promotional emails on or off for your account
POST /v1/account/password — Set or change your account password
GET /v1/billing/overage — Overage: state, rate and ceiling
POST /v1/billing/overage — Switch overage on or off
GET /v1/billing/portal — Self-service billing portal link
POST /v1/billing/portal — Billing portal link (console; confirms your password)
GET /v1/billing/upgrade-link — A signed link to your prorated upgrade page

Try it against live data

The free tier needs no credit card, and the sandbox endpoints need no key at all.

Get a free API key Quickstart