# Update a webhook by UID

> You're reading the Mindset v3 documentation. v3 is no longer sold; this is reference for existing customers. Mindset 4 docs are at /docs.

Mindset v3 REST API reference: Webhooks.

**PATCH** `/api/v1/appuid/{appUid}/webhooks/uid/{uid}`

## Base URL

Requests go to your region's API host, for example `https://a.api.mindset.ai`. Hosts: `https://a.api.mindset.ai`, `https://b.api.mindset.ai`, `https://c.api.mindset.ai`, `https://d.api.mindset.ai`.

## Authorization

- `x-api-key` (string, required, header)

  Your API key.

## Path parameters

- `appUid` (string, required, path)

  Your application's uid

* `uid` (string, required, path)

  Unique ID of the webhook

## Request body

Content type: `application/json`.

- `name` (string, body)

  Descriptive name for the webhook

* `url` (string, body)

  Webhook endpoint URL

- `entities` (string\[], body)

  Entity types to monitor

* `active` (boolean, body)

  Whether the webhook is active

```json
{
  "name": "string",
  "url": "string",
  "entities": [
    "agent"
  ],
  "active": true
}
```

## Responses

### 200

Successful update

```json
{
  "uid": "string",
  "name": "string",
  "url": "string",
  "secret": "string",
  "entities": [
    "string"
  ],
  "active": true,
  "createdAt": "string"
}
```

### 404

Webhook not found

### 422

Unprocessable Entity - Nothing to update

## Example request

```bash
curl -X PATCH "https://a.api.mindset.ai/api/v1/appuid/{appUid}/webhooks/uid/{uid}" \
  -H "x-api-key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","url":"string","entities":["agent"],"active":true}'
```