> ## Documentation Index
> Fetch the complete documentation index at: https://stage-docs.oktivo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Endpoint

> Update a webhook endpoint's URL, events, active status, agent filter or delivery format.

## Path Parameters

**webhookId** `string` *required*

The unique identifier of the webhook endpoint to update.

## Request Body

All fields are optional. Include only the fields you want to change.

**url** `string`

New delivery URL. Must use HTTPS.

**eventTypes** `array`

Updated list of event types to subscribe to. At least one is required if you send the field. See [Create Endpoint](https://stage-docs.oktivo.com/api-reference/webhooks/create-endpoint.md) for the valid values.

**description** `string`

Updated description.

**agentIds** `array`

Update the agent filter (up to 50 agents). Send an empty array to receive events from all agents. The older single `agentId` is still accepted, and `agentId: null` clears the filter.

**isActive** `boolean`

Set to `false` to pause the endpoint (stops receiving events) or `true` to re-enable it. Re-enabling also resets the failure counter, so an endpoint that was switched off automatically starts fresh.

**deliveryProfile** `string`

Delivery format: `standard` or `panzo`. Only valid for endpoints in standard payload mode (custom mode returns `400`). Applies to events enqueued after you save the change. See [Webhooks](https://stage-docs.oktivo.com/concepts/webhooks.md#panzo-delivery-format).

## Response

**success** `boolean`

Indicates if the update was successful.

**endpoint** `object`

The updated endpoint object. The secret is not included.

```json 200 Success theme={null}
{
  "success": true,
  "endpoint": {
    "webhookId": "wh_abc123def456",
    "url": "https://new-url.company.com/webhooks/oktivo",
    "eventTypes": ["call.ended", "call.analysis_ready", "call.completed"],
    "description": "Updated integration",
    "agentIds": ["agent_new_qualifier"],
    "isActive": true,
    "payloadMode": "standard",
    "deliveryProfile": "standard"
  }
}
```

```json 404 Not Found theme={null}
{
  "error": "Webhook endpoint not found"
}
```

> [!NOTE]
>
> This endpoint requires **JWT authentication**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.