---
title: "Standardize RT Structure Names"
method: POST
path: "/structures/standardize"
tags: ["RT Structures"]
---

# Standardize RT Structure Names

`POST /structures/standardize`

Standardizes a list of Radiation Therapy structure names using Aitrium's
RT Plan Standardizer.

## Request body

- ExternalStandardizeRequest — Request body for standardizing multiple structure names.
  - `structures` ExternalStructureInput[], required — List of structures to standardize.
    - `structure_name` string, required — The original structure name/label to be standardized.
    - `rt_plan_id` string, required — Identifier for the associated RT Plan.
    - `rt_structure_set_id` string, required — Identifier for the associated RT Structure Set.
    - `structure_type` string, nullable — Type of structure (e.g., VOLUME, ROI).
    - `dose_reference_type` string, nullable — Dose reference type (e.g., ORGAN_AT_RISK, TARGET).
    - `target_prescription_dose` number, float, nullable — Prescription dose in Gy, if applicable.
    - `observation_type` string, nullable — Observation type (e.g., ORGAN, CTV, PTV, GTV).
    - `structure_volume` number, float, nullable — Volume of the structure in cm³.
    - `body_part_examined` string, nullable — Body part examined (e.g., HEAD_NECK, CHEST).
  - `language` string — The primary language of the original_name fields (e.g., 'en', 'fr').
  - `project_id` string, uuid, nullable — Optional project ID for context-specific standardization rules.

## Response `200`

Successfully standardized structures.

- ExternalStandardizeResponse — Response body containing the list of standardized labels.
  - `standardized_labels` ExternalStandardizedLabel[], required
    - `original_name` string, required — The original structure name provided in the request.
    - `new_label` string, required — The standardized label.
    - `confidence` number, float, required — Confidence score of the standardization.
    - `rt_plan_id` string, required — Identifier for the RT Plan, echoed from input.
    - `rt_structure_set_id` string, required — Identifier for the RT Structure Set, echoed from input.

## Other responses

- `400` — Bad Request (e.g., invalid input data).
- `401` — Unauthorized (Invalid or missing token).
- `403` — Forbidden (Client configuration error).
- `404` — Not Found (e.g., No active nomenclature found).
- `500` — Internal Server Error (e.g., error communicating with microservice).
- `502` — Bad Gateway (Error response from standardization service).
- `503` — Service Unavailable (Could not connect to standardization service).
- `504` — Gateway Timeout (Standardization service timed out).

---

[API](https://skmtc.dev/newleaf-ai/apis/external-api.md) · [All operations](https://skmtc.dev/newleaf-ai/apis/external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/newleaf-ai/external-api/revisions/e648f609ff4a/schema)