# Update Webhook

This endpoint allows you to update a previously registered webhook.

It accepts the same parameters as the Register New Webhook endpoint and
responds with an updated Webhook entity


Endpoint: PUT /v2/webhooks/{id}
Security: Bearer-Auth

## Path parameters:

  - `id` (string, required)

## Request fields (application/json):

  - `kind` (string)
    Enum: "order", "confirmation_document_available", "certificate_document_available"

  - `endpoint_url` (string)

## Response 200 fields (application/json):

  - `id` (string)
    A unique identifier for the webhook, represented as a universally unique identifier (UUID)

  - `last_failed_at` (string,null)
    The timestamp of the most recent failed delivery attempt. If no failures have occurred, this field is null

  - `last_sent_at` (string,null)
    The timestamp of the most recent successful delivery attempt. If no attempts have been made, this field is null

  - `failed_attempts` (integer)
    The total number of consecutive failed delivery attempts

  - `kind` (string)
    The type of event that triggers the webhook
    Enum: "order", "carbon_activity_expired", "confirmation_document_available", "certificate_document_available"

  - `endpoint_url` (string)
    The URL where the webhook payloads are sent. Must be a valid URI that accepts POST requests

## Response 403 fields (application/json):

  - `errors` (array)

  - `errors.code` (string, required)
    An application-specific error code, expressed as a string value.
    Enum: "field_validation_error", "server_error", "not_authorized", "not_found", "invalid_methodology", "invalid_type"

  - `errors.detail` (string)
    A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

  - `errors.source` (object)
    An object containing references to the primary source of the error

  - `errors.source.id` (string)

  - `errors.source.attribute` (string, required)

  - `errors.source.model` (string)

## Response 404 fields (application/json):

  - `errors` (array)

  - `errors.code` (string, required)
    An application-specific error code, expressed as a string value.
    Enum: "field_validation_error", "server_error", "not_authorized", "not_found", "invalid_methodology", "invalid_type"

  - `errors.detail` (string)
    A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

  - `errors.source` (object)
    An object containing references to the primary source of the error

  - `errors.source.id` (string)

  - `errors.source.attribute` (string, required)

  - `errors.source.model` (string)

## Response 422 fields (application/json):

  - `errors` (array)

  - `errors.code` (string, required)
    An application-specific error code, expressed as a string value.
    Enum: "field_validation_error", "server_error", "not_authorized", "not_found", "invalid_methodology", "invalid_type"

  - `errors.detail` (string)
    A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

  - `errors.source` (object)
    An object containing references to the primary source of the error

  - `errors.source.id` (string)

  - `errors.source.attribute` (string, required)

  - `errors.source.model` (string)