---
title: "Update a notification transport"
method: PUT
path: "/notifications/transports/{id}"
tags: ["Notifications"]
---

# Update a notification transport

`PUT /notifications/transports/{id}`

Replace the mutable configuration of one notification transport; omitted credentials remain unchanged and explicit empty credentials are cleared

## Path parameters

- `id` integer, required

## Request body

- GithubComAlchemillahqSylveInternalServicesNotificationsTransportInput
  - `discord` GithubComAlchemillahqSylveInternalServicesNotificationsDiscordTransportConfigUpdate
    - `webhookUrl` string
  - `email` GithubComAlchemillahqSylveInternalServicesNotificationsEmailTransportConfigUpdate
    - `recipients` string[]
    - `smtpFrom` string
    - `smtpHost` string
    - `smtpPassword` string
    - `smtpPort` integer
    - `smtpUseTls` boolean
    - `smtpUsername` string
  - `enabled` boolean
  - `name` string
  - `ntfy` GithubComAlchemillahqSylveInternalServicesNotificationsNtfyTransportConfigUpdate
    - `authToken` string
    - `baseUrl` string
    - `topic` string
  - `type` string

## Response `200`

Success

- GithubComAlchemillahqSylveInternalAPIResponseGithubComAlchemillahqSylveInternalServicesNotificationsTransportConfigView
  - `data` GithubComAlchemillahqSylveInternalServicesNotificationsTransportConfigView
    - `transports` GithubComAlchemillahqSylveInternalServicesNotificationsTransportConfigEntryView[]
      - `discord` GithubComAlchemillahqSylveInternalServicesNotificationsDiscordTransportConfigView
        - `webhookUrl` string
      - `email` GithubComAlchemillahqSylveInternalServicesNotificationsEmailTransportConfigView
        - `hasPassword` boolean
        - `recipients` string[]
        - `smtpFrom` string
        - `smtpHost` string
        - `smtpPort` integer
        - `smtpUseTls` boolean
        - `smtpUsername` string
      - `enabled` boolean
      - `id` integer
      - `name` string
      - `ntfy` GithubComAlchemillahqSylveInternalServicesNotificationsNtfyTransportConfigView
        - `baseUrl` string
        - `hasAuthToken` boolean
        - `topic` string
      - `type` string
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `413` — Request Entity Too Large
- `500` — Internal Server Error

---

[API](https://skmtc.net/alchemillahq/apis/sylve-api.md) · [All operations](https://skmtc.net/alchemillahq/apis/sylve-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alchemillahq/sylve-api/revisions/7a7bea85004e/schema)