> For the complete documentation index, see [llms.txt](https://docs.pulsoid.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pulsoid.net/widgets-management/update-widget.md).

# Update Widget

This method allows updating the information of the user's [widget](/widgets-management/widget-entity.md).

**Request**

<table><thead><tr><th width="164">name</th><th>value</th></tr></thead><tbody><tr><td>url</td><td><code>https://dev.pulsoid.net/api/v1/widgets/{widget.id}</code></td></tr><tr><td>method</td><td><code>POST</code></td></tr><tr><td>scope</td><td><code>widgets:update</code></td></tr></tbody></table>

**Body Param** Accepts JSON object with the following field

<table><thead><tr><th width="162">name</th><th>value</th></tr></thead><tbody><tr><td>configuration</td><td>Json representing new widget's configuration</td></tr></tbody></table>

**Headers Parameters explained:**

<table><thead><tr><th width="166">name</th><th>value</th><th>description</th></tr></thead><tbody><tr><td>Authorization</td><td>Bearer {auth token}</td><td>How to obtains access token<br><a href="https://docs.pulsoid.net/#how-to-obtain-an-authorization-token">https://docs.pulsoid.net/#how-to-obtain-an-authorization-token</a></td></tr></tbody></table>

**Response**

The response is an updated [widget](/widgets-management/widget-entity.md).

**Curl Request Example**

```bash
curl --request POST \
  --url https://pulsoid.net/api/v1/widgets/40b0131e-fe68-4020-90a0-1a5eb78fd9b4 \
  --header 'Authorization: Bearer 8c4da3ce-7ed7-4a19-a1f1-058498661e45' \
  --header 'Content-Type: application/json' \
  --data '{
  "configuration" : {
    "font": "Comics Sans"
  }
}'
```

**Response Example**

```json
{
  "widget": {
    "id": "40b0131e-fe68-4020-90a0-1a5eb78fd9b4",
    "meta_id": "b828337f-cdb0-49d2-8e55-9b1285cd0d22",
    "configuration": {
      "font": "Comics Sans"
    },
    "name": "Widget 1"
  }
}
```