Skip to main content
POST
/
v2
/
workspace
/
advancedwebhookconfig
/
update
Update Advanced Webhook Config
curl --request POST \
  --url https://api.velt.dev/v2/workspace/advancedwebhookconfig/update \
  --header 'Content-Type: application/json' \
  --header 'x-velt-api-key: <x-velt-api-key>' \
  --header 'x-velt-auth-token: <x-velt-auth-token>' \
  --data '
{
  "data": {
    "isEnabled": true,
    "encryptData": true,
    "encodeData": true,
    "publicKey": "<string>",
    "enableDataProtection": true
  }
}
'
{
  "result": {
    "status": "success",
    "message": "Advanced webhook configuration updated successfully.",
    "data": {
      "isEnabled": true,
      "encryptData": false,
      "encodeData": false,
      "publicKey": "",
      "enableDataProtection": false
    }
  }
}
Use this API to update the advanced webhook configuration for a workspace. At least one of isEnabled, encryptData, encodeData, publicKey or enableDataProtection must be provided.
This endpoint uses API-key-level auth: pass x-velt-api-key and x-velt-auth-token as headers. You can obtain these from the Get Auth Tokens endpoint.
This endpoint is for Advanced Webhooks. For Basic Webhooks, use Update Webhook Config.
First enable. If advanced webhooks have never been configured for the workspace, the first request must include isEnabled: true — this provisions the underlying webhook application for your workspace. Sending only other fields before the first enable returns a FAILED_PRECONDITION error. After the first enable, you can manage delivery endpoints via the endpoint management APIs.
Partial update. Only the fields you send are changed; all other stored values are preserved. The response data echoes the latest post-write state — the same shape returned by Get Advanced Webhook Config.

​
Endpoint

POST https://api.velt.dev/v2/workspace/advancedwebhookconfig/update

​
Headers

​
x-velt-api-key
string
required
Your API key.
​
x-velt-auth-token
string
required
Your Auth Token.

​
Body

​
Params

​
data
object
required

​
Example Request

{
  "data": {
    "isEnabled": true,
    "encryptData": false,
    "encodeData": false
  }
}

​
Example Response

​
Success Response

{
  "result": {
    "status": "success",
    "message": "Advanced webhook configuration updated successfully.",
    "data": {
      "isEnabled": true,
      "encryptData": false,
      "encodeData": false,
      "publicKey": "",
      "enableDataProtection": false
    }
  }
}

​
Failure Response

{
  "error": {
    "status": "INVALID_ARGUMENT",
    "message": "At least one of isEnabled, encryptData, encodeData, publicKey or enableDataProtection must be provided."
  }
}

{
  "result": {
    "status": "success",
    "message": "Advanced webhook configuration updated successfully.",
    "data": {
      "isEnabled": true,
      "encryptData": false,
      "encodeData": false,
      "publicKey": "",
      "enableDataProtection": false
    }
  }
}