v1

latestOpenAPI 3.0.02026-07-142740323.4 KB
Studies

Anonymize study

Start a job that will anonymize all the DICOM instances within the study whose identifier is provided in the URL. The modified DICOM instances will be stored into a brand new study, whose Orthanc identifiers will be returned by the job. https://book.orthanc-server.com/users/anonymization.html#anonymization-of-patients-studies-or-series

post/studies/{id}/anonymize

Path parameters

idstring required

Orthanc identifier of the study of interest

Request body

Asynchronousboolean

If true, run the job in asynchronous mode, which means that the REST API call will immediately return, reporting the identifier of a job. Prefer this flavor wherever possible.

DicomVersionstring

Version of the DICOM standard to be used for anonymization. Check out configuration option DeidentifyLogsDicomVersion for possible values.

Forceboolean

Allow the modification of tags related to DICOM identifiers, at the risk of breaking the DICOM model of the real world

Keepstring[]

List of DICOM tags whose value must not be destroyed by the anonymization. Starting with Orthanc 1.9.4, paths to subsequences can be provided using the same syntax as the dcmodify command-line tool (wildcards are supported as well).

KeepPrivateTagsboolean

Keep the private tags from the DICOM instances (defaults to false)

KeepSourceboolean

If set to false, instructs Orthanc to the remove original resources. By default, the original resources are kept in Orthanc.

Permissiveboolean

If true, ignore errors during the individual steps of the job.

Prioritynumber

In asynchronous mode, the priority of the job. The lower the value, the higher the priority.

PrivateCreatorstring

The private creator to be used for private tags in Replace

Removestring[]

List of additional tags to be removed from the DICOM instances. Starting with Orthanc 1.9.4, paths to subsequences can be provided using the same syntax as the dcmodify command-line tool (wildcards are supported as well).

Replaceobject

Associative array to change the value of some DICOM tags in the DICOM instances. Starting with Orthanc 1.9.4, paths to subsequences can be provided using the same syntax as the dcmodify command-line tool (wildcards are supported as well).

Synchronousboolean

If true, run the job in synchronous mode, which means that the HTTP answer will directly contain the result of the job. This is the default, easy behavior, but it is not desirable for long jobs, as it might lead to network timeouts.

Transcodestring

Transcode the DICOM instances to the provided DICOM transfer syntax: https://book.orthanc-server.com/faq/transcoding.html

Response

IDstring

In asynchronous mode, identifier of the job

Pathstring

In asynchronous mode, path to access the job in the REST API