---
title: "Update DICOM modality"
method: PUT
path: "/modalities/{id}"
tags: ["Networking"]
---

# Update DICOM modality

`PUT /modalities/{id}`

Define a new DICOM modality, or update an existing one. This change is permanent iff. `DicomModalitiesInDatabase` is `true`, otherwise it is lost at the next restart of Orthanc.

## Path parameters

- `id` string, required

## Request body

- object
  - `AET` string — AET of the remote DICOM modality
  - `AllowEcho` boolean — Whether to accept C-ECHO SCU commands issued by the remote modality
  - `AllowFind` boolean — Whether to accept C-FIND SCU commands issued by the remote modality
  - `AllowFindWorklist` boolean — Whether to accept C-FIND SCU commands for worklists issued by the remote modality
  - `AllowGet` boolean — Whether to accept C-GET SCU commands issued by the remote modality
  - `AllowMove` boolean — Whether to accept C-MOVE SCU commands issued by the remote modality
  - `AllowStorageCommitment` boolean — Whether to accept storage commitment requests issued by the remote modality
  - `AllowStore` boolean — Whether to accept C-STORE SCU commands issued by the remote modality
  - `AllowTranscoding` boolean — Whether to allow transcoding for operations initiated by this modality. This option applies to Orthanc C-GET SCP and to Orthanc C-STORE SCU. It only has an effect if the global option `EnableTranscoding` is set to `true`.
  - `Host` string — Host address of the remote DICOM modality (typically, an IP address)
  - `Manufacturer` string — Manufacturer of the remote DICOM modality (check configuration option `DicomModalities` for possible values
  - `Port` number — TCP port of the remote DICOM modality
  - `UseDicomTls` boolean — Whether to use DICOM TLS in the SCU connection initiated by Orthanc (new in Orthanc 1.9.0)

## Response `200`

---

[API](https://skmtc.net/orthancserver/apis/orthanc-server.md) · [All operations](https://skmtc.net/orthancserver/apis/orthanc-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orthancserver/orthanc-server/versions/af646f6f871b/schema)