---
title: "Update incident provider"
method: PUT
path: "/incident-providers/{providerId}"
tags: ["incidents"]
---

# Update incident provider

`PUT /incident-providers/{providerId}`

Replaces an incident provider. Existing secret values are preserved when omitted. Developer, manager, or admin only.

## Path parameters

- `providerId` string, required

## Query parameters

- `remoteNode` string

## Request body

- union — Incident provider input
  - IncidentPagerDutyProviderInputEnvelope — PagerDuty incident provider input
    - `name` string, required — Human-readable provider name
    - `type` 'pagerduty', required
    - `enabled` boolean, required — Whether this provider can receive incident events
    - `pagerDuty` IncidentPagerDutyProviderInput, required — PagerDuty Events API v2 provider input. The routing key is encrypted at rest.
      - `routingKey` string — PagerDuty Events API v2 routing key. Omit on updates to preserve the existing key.
      - `clearRoutingKey` boolean — Clear the stored routing key.
  - IncidentSolarWindsProviderInputEnvelope — SolarWinds Incident Response provider input
    - `name` string, required — Human-readable provider name
    - `type` 'solarwinds_incident_response', required
    - `enabled` boolean, required — Whether this provider can receive incident events
    - `solarWinds` IncidentSolarWindsProviderInput, required — SolarWinds Incident Response incoming webhook provider input. The webhook URL is encrypted at rest.
      - `webhookUrl` string, uri — Incoming webhook URL. Omit on updates to preserve the existing URL.
      - `clearWebhookUrl` boolean — Clear the stored webhook URL.
      - `allowInsecureHttp` boolean — Allow plain HTTP webhook URLs. Disabled by default.
      - `allowPrivateNetwork` boolean — Allow loopback or private network webhook targets. Disabled by default.

## Response `200`

Incident provider updated

- IncidentProvider — Incident provider. Secrets are never returned.
  - `id` string, required — Stable provider ID
  - `name` string, required — Human-readable provider name
  - `type` 'pagerduty' | 'solarwinds_incident_response', required — Incident provider type
  - `enabled` boolean, required — Whether this provider can receive incident events
  - `pagerDuty` IncidentPagerDutyProvider — Public PagerDuty provider details
    - `routingKeyConfigured` boolean, required — Whether a PagerDuty routing key is configured
    - `routingKeyPreview` string — Redacted routing key preview
  - `solarWinds` IncidentSolarWindsProvider — Public SolarWinds Incident Response provider details
    - `webhookUrlConfigured` boolean, required — Whether an incoming webhook URL is configured
    - `webhookUrlPreview` string — Redacted webhook URL preview
    - `allowInsecureHttp` boolean — Whether this provider allows plain HTTP webhook URLs
    - `allowPrivateNetwork` boolean — Whether this provider allows loopback or private network webhook targets
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `updatedBy` string — User ID that last updated the provider

## Other responses

- `400` — Invalid incident provider
- `403` — Forbidden - requires an active Dagu license or trial
- `404` — Incident provider not found
- `default` — Unexpected error

---

[API](https://skmtc.net/dagucloud/apis/dagu.md) · [All operations](https://skmtc.net/dagucloud/apis/dagu/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dagucloud/dagu/revisions/93cc41f2018a/schema)