---
title: "UpdateWebhook"
method: PUT
path: "/registry/{registry_ref}/webhooks/{webhook_identifier}"
tags: ["Webhooks"]
---

# UpdateWebhook

`PUT /registry/{registry_ref}/webhooks/{webhook_identifier}`

Returns Webhook Details

## Path parameters

- `registry_ref` string, required
- `webhook_identifier` string, required

## Request body

- WebhookRequest
  - `identifier` string, required
  - `name` string, required
  - `description` string
  - `url` string, required
  - `enabled` boolean, required
  - `insecure` boolean, required
  - `secretIdentifier` string
  - `secretSpacePath` string
  - `secretSpaceId` integer
  - `triggers` Trigger[]
  - `extraHeaders` ExtraHeader[]
    - `key` string, required
    - `value` string, required
    - `masked` boolean

## Response `201`

response for create, get and update webhook

- object
  - `status` 'SUCCESS' | 'FAILURE' | 'ERROR', required — Indicates if the request was successful or not
  - `data` Webhook, required — Harness Regstries Webhook
    - `version` integer
    - `identifier` string, required
    - `name` string, required
    - `description` string
    - `url` string, required
    - `createdAt` string
    - `createdBy` integer
    - `modifiedAt` string
    - `enabled` boolean, required
    - `internal` boolean
    - `secretIdentifier` string
    - `secretSpacePath` string
    - `secretSpaceId` integer
    - `insecure` boolean, required
    - `triggers` Trigger[]
    - `latestExecutionResult` 'SUCCESS' | 'RETRIABLE_ERROR' | 'FATAL_ERROR' — refers to webhook execution
    - `extraHeaders` ExtraHeader[]
      - `key` string, required
      - `value` string, required
      - `masked` boolean

## Other responses

- `400` — Bad request
- `401` — Unauthenticated
- `403` — Unauthorized
- `404` — The specified resource was not found
- `500` — Internal server error

## Changes

- **2026-01-02** `d41ab9a68bbd` — 1 info
  - added the non-success response with the status `404`
- **2025-12-12** `fc6dc4501402` — 2 info
  - added the new optional request property `extraHeaders/items/masked`
  - added the optional property `data/extraHeaders/items/masked` to the response with the `201` status
- **2025-03-24** `c55e0097ca2a` — 1 breaking, 1 info
  - removed the enum value `ARTIFACT_MODIFICATION` of the request property `triggers/items/`
  - removed the `ARTIFACT_MODIFICATION` enum value from the `data/triggers/items/` response property for the response status `201`
- **2025-03-18** `997f7461cf85` — 1 breaking
  - the `secretSpaceId` request property format changed from no format to `int64`
- **2025-03-11** `b3c2e43cf388` — 2 breaking, 2 info
  - the request property `extraHeaders/items/key` became required
  - the request property `extraHeaders/items/value` became required
  - the response property `data/extraHeaders/items/key` became required for the status `201`
  - the response property `data/extraHeaders/items/value` became required for the status `201`

[Full history](https://skmtc.dev/harness/apis/harness-artifact-registry-api/changes/registry/:registry_ref/webhooks/:webhook_identifier/put.md)

---

[API](https://skmtc.dev/harness/apis/harness-artifact-registry-api.md) · [All operations](https://skmtc.dev/harness/apis/harness-artifact-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/harness/harness-artifact-registry-api/revisions/e315ed26a2f1/schema)