# ListWebhooks

Returns List of Webhook Details

Endpoint: GET /har/api/v1/registry/{registry_ref}/webhooks
Version: 1.0
Security: x-api-key

## Path parameters:

  - `registry_ref` (string, required)
    Reference to the scope in which the registry exists.

Format depends on the scope:

- Account-level: account_id/registry_name/+
- Organization-level: account_id/org_id/registry_name/+
- Project-level: account_id/org_id/project_id/registry_name/+

The /+ suffix is used internally to route scoped requests.
It must be included exactly as shown in the URL.

## Query parameters:

  - `page` (integer)
    Current page number

  - `size` (integer)
    Number of items per page

  - `sort_order` (string)
    sortOrder

  - `sort_field` (string)
    sortField

  - `search_term` (string)
    search Term.

## Response 200 fields (application/json):

  - `data` (object, required)
    A list of Harness Registries webhooks

  - `data.itemCount` (integer)
    The total number of items
    Example: 1

  - `data.pageCount` (integer)
    The total number of pages
    Example: 100

  - `data.pageIndex` (integer)
    The current page

  - `data.pageSize` (integer)
    The number of items per page
    Example: 1

  - `data.webhooks` (array, required)
    A list of Registries webhooks

  - `data.webhooks.createdAt` (string)

  - `data.webhooks.createdBy` (integer)

  - `data.webhooks.description` (string)

  - `data.webhooks.enabled` (boolean, required)

  - `data.webhooks.extraHeaders` (array)

  - `data.webhooks.extraHeaders.key` (string, required)

  - `data.webhooks.extraHeaders.masked` (boolean)

  - `data.webhooks.extraHeaders.value` (string, required)

  - `data.webhooks.identifier` (string, required)

  - `data.webhooks.insecure` (boolean, required)

  - `data.webhooks.internal` (boolean)

  - `data.webhooks.latestExecutionResult` (string)
    refers to webhook execution
    Enum: "SUCCESS", "RETRIABLE_ERROR", "FATAL_ERROR"

  - `data.webhooks.modifiedAt` (string)

  - `data.webhooks.name` (string, required)

  - `data.webhooks.secretIdentifier` (string)

  - `data.webhooks.secretSpaceId` (integer)

  - `data.webhooks.secretSpacePath` (string)

  - `data.webhooks.triggers` (array)
    Enum: "ARTIFACT_CREATION", "ARTIFACT_DELETION"

  - `data.webhooks.url` (string, required)

  - `data.webhooks.version` (integer)

  - `status` (string, required)
    Request processing status indicator
    Enum: "SUCCESS", "FAILURE", "ERROR"

## Response 400 fields (application/json):

  - `code` (string, required)
    The HTTP error code
    Example: "404"

  - `details` (object)
    Additional context and details about the error.
May include field-specific validation errors or debugging information.
    Example: {"field":"registry_identifier","reason":"Registry does not exist in the specified project","value":"invalid-registry"}

  - `message` (string, required)
    Human-readable error message explaining what went wrong
    Example: "Registry not found"