# Update webhook subscription callback URL or status

Updates the callback URL and/or the status (active or inactive) for an existing webhook subscription.

Features:
- Validates the new callback URL format; only HTTPS is supported
- Updates the subscription status to active or inactive

Example Use Case: An operations manager needs to change the webhook endpoint URL after migrating to a new server. Using this endpoint, they can update the callback URL without recreating the entire subscription.

For more information on setting up and managing webhooks, see the Event Notifications (Webhook) Guide.

Endpoint: PATCH /api/v2/webhooks/subscriptions/{subscriptionId}
Version: 2.4.0
Security: X-Api-Client-Id, X-Auth-Token

## Path parameters:

  - `subscriptionId` (string, required)
    The unique identifier of the webhook subscription to update.
    Example: "webhook-sub-12345"

## Request fields (application/json):

  - `callbackUrl` (string)
    The new URL where webhook notifications will be sent. Must be a valid HTTPS URL.
    Example: "https://new-example.com/webhooks"

  - `status` (string)
    Status of the webhook subscription indicating whether it is active and receiving notifications or inactive.
    Enum: "ACTIVE", "INACTIVE"

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier for the webhook subscription.
    Example: "webhook-sub-12345"

  - `event` (string)
    The event type that this subscription is listening for.
    Example: "FLIGHT_UPDATE"

  - `callbackUrl` (string)
    The URL where webhook notifications will be sent.
    Example: "https://example.com/webhooks"

  - `status` (string)
    Status of the webhook subscription indicating whether it is active and receiving notifications or inactive.
    Enum: "ACTIVE", "INACTIVE"

  - `createdAtDateTime` (string)
    The date and time when the webhook subscription was created.
    Example: "2024-01-15T10:30:00.000Z"

  - `updatedAtDateTime` (string)
    The date and time when the webhook subscription was last updated.
    Example: "2024-01-15T10:30:00.000Z"

  - `expirationDateTime` (string)
    The date and time when the webhook subscription will expire.
    Example: "2024-02-15T10:30:00.000Z"


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields