Mindset v3 / Deploy in your app / Webhooks

Update a webhook by UID

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-keystringheaderrequired

Your API key.

Path parameters

appUidstringpathrequired

Your application's uid

uidstringpathrequired

Unique ID of the webhook

Request body

Content type: application/json.

namestringbody

Descriptive name for the webhook

urlstringbody

Webhook endpoint URL

entitiesstring[]body

Entity types to monitor

activebooleanbody

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}'