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

# List Destination Providers

> ListDestinationProviders serves the in-code provider catalog (the off-the-
 shelf destination presets) and the event bundles the create flow offers. It
 is a pure registry projection — no store access — read-gated like the other
 list RPCs.



## OpenAPI

````yaml GET /v1/webhooks/providers
openapi: 3.0.3
info:
  title: Dome Platform API
  description: Connect and REST APIs for the Dome agent governance platform.
  version: 2.0.0
servers:
  - url: https://api.domesystems.ai
    description: Production
security: []
tags:
  - name: Agents
  - name: Authorization
  - name: Guards
  - name: Tools
  - name: Tool Catalog
  - name: Models
  - name: Model Pools
  - name: Quotas
  - name: Gateways
  - name: Webhooks
  - name: Audit
  - name: Workspaces
  - name: Access Control
  - name: Tenants
  - name: Platform Keys
  - name: Enrollment
  - name: Platform
  - name: Identity
paths:
  /v1/webhooks/providers:
    get:
      tags:
        - Webhooks
      description: >-
        ListDestinationProviders serves the in-code provider catalog (the
        off-the-
         shelf destination presets) and the event bundles the create flow offers. It
         is a pure registry projection — no store access — read-gated like the other
         list RPCs.
      operationId: EventingService_ListDestinationProviders
      parameters:
        - name: workspace_id
          in: query
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListDestinationProvidersResponse'
components:
  schemas:
    ListDestinationProvidersResponse:
      type: object
      properties:
        providers:
          type: array
          items:
            $ref: '#/components/schemas/DestinationProvider'
        bundles:
          type: array
          items:
            $ref: '#/components/schemas/EventBundle'
      description: >-
        ListDestinationProvidersResponse is the provider catalog projection:
        every
         registered provider plus the shared event bundles for the create-flow chooser.
    DestinationProvider:
      type: object
      properties:
        key:
          type: string
        display_name:
          type: string
        description:
          type: string
        logo_slug:
          type: string
        docs_url:
          type: string
        instructions_md:
          type: string
        credential_fields:
          type: array
          items:
            $ref: '#/components/schemas/ProviderField'
          description: >-
            credential_fields are secret inputs (Vault-routed); settings_fields
            are
             non-secret inputs (persisted, fed to the URL builder).
        settings_fields:
          type: array
          items:
            $ref: '#/components/schemas/ProviderField'
        recommended_bundle:
          type: string
          description: >-
            recommended_bundle is the event bundle key pre-selected for this
            provider.
        secret_in_body:
          type: boolean
          description: >-
            secret_in_body marks a provider whose credential rides in the
            request body
             (PagerDuty); Dome omits its own signature for these.
        endpoint_is_secret:
          type: boolean
          description: >-
            endpoint_is_secret marks a provider whose endpoint URL embeds a
            capability
             token (Slack/Sumo/Jira/Zapier/Tines), so views display-redact the URL.
        example_body:
          type: string
          description: >-
            example_body is the request body Dome would POST for a
            representative event
             (a fixed agent.suspended fixture run through the provider's transform), for a
             create-flow preview. A passthrough (nil-transform) provider shows the raw
             canonical body; a secret-in-body provider (PagerDuty) shows the
             {{DOME_SECRET:…}} placeholder verbatim (the secret never leaves Vault). Empty
             if the sample could not be rendered.
        secret_url_field:
          type: string
          description: >-
            secret_url_field, when non-empty, names the settings_fields key
            whose value
             is a secret capability URL (the provider's endpoint embeds a bearer token).
             The dashboard renders that one settings field write-only/masked, and the
             value is routed to Vault rather than persisted. Non-empty exactly when
             endpoint_is_secret is true.
      description: >-
        DestinationProvider is one off-the-shelf destination preset. It carries
        the
         display metadata, the credential/settings form schemas, and the capability
         flags the UI needs; the URL/auth/transform behavior stays server-side.
    EventBundle:
      type: object
      properties:
        key:
          type: string
        label:
          type: string
        description:
          type: string
        event_types:
          type: array
          items:
            type: string
      description: >-
        EventBundle is a curated group of event types offered as a one-click
        preset in
         the destination create flow's event chooser, referenced by a provider's
         recommended_bundle.
    ProviderField:
      type: object
      properties:
        key:
          type: string
        label:
          type: string
        placeholder:
          type: string
        type:
          type: string
          description: type is one of "text", "password", "select".
        required:
          type: boolean
        options:
          type: array
          items:
            type: string
          description: >-
            options is the closed choice set for a "select" field; empty
            otherwise.
        help:
          type: string
        default_value:
          type: string
        pattern:
          type: string
          description: >-
            pattern is a full-match regex the value must satisfy (empty = no
            pattern).
             The server enforces it; clients mirror it for inline validation so a
             malformed value is caught before the round trip.
      description: >-
        ProviderField is one operator-supplied input in a provider's destination
        form
         (a credential or a setting). It is the data-driven schema the dashboard renders.

````