---
title: "PUT /udl/airtransportmission/{id}"
method: PUT
path: "/udl/airtransportmission/{id}"
tags: ["AirOperations"]
---

# PUT /udl/airtransportmission/{id}

`PUT /udl/airtransportmission/{id}`

## Request

- Base URL: `https://unifieddatalibrary.com`
- URL: `https://unifieddatalibrary.com/udl/airtransportmission/{id}`
- Auth: none declared

Service operation to update a single AirTransportMission record. A specific role is required to perform this service operation. Please contact the UDL team for assistance.

## Path parameters

- `id` string, required

## Request body

- AirTransportMissionIngest: The information in an Air Transport Mission contains unique identification, description of the mission objective, aircraft and crew assignments, mission alias, embarkation/debarkation cargo locations, priority, and other mission characteristics.
  - `id` string: Unique identifier of the record, auto-generated by the system.
  - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format.
  - `origMissionId` string: The mission identifier provided by the originating source.
  - `amcMissionId` string: Air Mobility Command (AMC) mission identifier according to Mobility Air Forces (MAF) Encode/Decode procedures.
  - `gdssMissionId` string: Global Decision Support System (GDSS) mission unique identifier.
  - `atoMissionId` string: The mission number according to the Air Tasking Order (ATO).
  - `prevMissionId` string: Unique identifier of the previous air transport mission provided by the originating source. Provides a method for the data provider to link air transport missions together chronologically for tasking and planning purposes.
  - `prevAMCMissionId` string: Air Mobility Command (AMC) mission identifier of the previous air transport mission. Provides a method for AMC to link air transport missions together chronologically for tasking and planning purposes.
  - `nextMissionId` string: Unique identifier of the next mission provided by the originating source. Provides a method for the data provider to link air transport missions together chronologically for tasking and planning purposes.
  - `nextAMCMissionId` string: Air Mobility Command (AMC) mission identifier of the next air transport mission. Provides a method for AMC to link air transport missions together chronologically for tasking and planning purposes.
  - `objective` string: A description of this mission's objective.
  - `purpose` string: A description of this mission's purpose (e.g. why this mission needs to happen, what is the mission supporting, etc.).
  - `jcsPriority` string: Highest Joint Chiefs of Staff priority of this mission.
  - `cw` boolean: Flag indicating this is a close watch mission.
  - `type` string: The type of mission (e.g. SAAM, CHNL, etc.).
  - `firstPickUp` string: The International Civil Aviation Organization (ICAO) site code of first cargo pick up.
  - `lastDropOff` string: The International Civil Aviation Organization (ICAO) site code of last cargo drop off.
  - `alias` string: Mission alias.
  - `callSign` string: The call sign for this mission.
  - `atoCallSign` string: The call sign assigned to this mission according to the Air Tasking Order (ATO).
  - `m1` string: Mode-1 interrogation response (mission code), indicating mission or aircraft type.
  - `m2` string: Mode-2 interrogation response (military identification code).
  - `m3a` string: Mode-3/A interrogation response (aircraft identification), provides a 4-digit octal identification code for the aircraft, assigned by the air traffic controller. Mode-3/A is shared military/civilian use.
  - `operation` string: The name of the operation that this mission supports.
  - `naf` string: Numbered Air Force (NAF) organization that owns the mission.
  - `allocatedUnit` string: The unit the mission is allocated to.
  - `node` string: Designates the location responsible for mission transportation, logistics, or distribution activities for an Area of Responsibility (AOR) within USTRANSCOM.
  - `abp` string: The Air Battle Plan used to coordinate and integrate air assets for this mission.
  - `loadCategoryType` string: Load type of this mission (e.g. CARGO, MIXED, PASSENGER).
  - `state` string: Current state of the mission.
  - `sourceSysDeviation` number, double: The number of minutes a mission is off schedule based on the source system's business rules. Positive numbers are early, negative numbers are late.
  - `apacsId` string: The Aircraft and Personnel Automated Clearance System (APACS) system identifier used to process and approve clearance requests.
  - `dipWorksheetName` string: Identifier of the Diplomatic Clearance Worksheet used to coordinate aircraft clearance requests.
  - `createdAt` string, date-time: Time the row was created in the database, auto-populated by the system.
  - `createdBy` string: Application user who created the row in the database, auto-populated by the system.
  - `updatedAt` string, date-time: Time the row was updated in the database, auto-populated by the system.
  - `updatedBy` string: Application user who updated the row in the database, auto-populated by the system.
  - `sourceDL` string: The source data library from which this record was received. This could be a remote or tactical UDL or another data library. If null, the record should be assumed to have originated from the primary Enterprise UDL.
  - `source` string, required: Source of the data.
  - `origin` string: Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin.
  - `dataMode` 'REAL' | 'TEST' | 'SIMULATED' | 'EXERCISE', required: Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data: REAL: Data collected or produced that pertains to real-world objects, events, and analysis. TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics. EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data. SIMULATED: Synthetic data generated by a model to mimic real-world datasets.
  - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system.
  - `requirements` AircraftMissionRequirementsIngest[]: Collection of Requirements planned to be associated with this Air Transport Mission.
    - `gdssReqId` string: Global Decision Support System (GDSS) mission requirement identifier.
    - `onloadId` integer: Identifier of the onload itinerary location.
    - `onloadLOCode` string: Onload location code.
    - `offloadId` integer: Identifier of the offload itinerary location.
    - `offloadLOCode` string: Offload location code.
    - `uln` string: Unit line number.
    - `transReqNum` string: Transportation requirement number.
    - `projName` string: Project name.
    - `oplan` string: Identification number of the Operation Plan (OPLAN) associated with this mission.
    - `numPax` integer: Number of passengers associated with the mission.
    - `numLitter` integer: Number of litter patients tasked for the mission.
    - `numAmbulatory` integer: Number of ambulatory patients tasked for the mission.
    - `numAttendant` integer: Number of attendants tasked for the mission.
    - `bulkWeight` number, double: Total weight of the bulk cargo, in kilograms.
    - `oversizeWeight` number, double: Total weight of the oversized cargo, in kilograms.
    - `outsizeWeight` number, double: Total weight of the outsize cargo, in kilograms.
    - `ead` string, date-time: Earliest available date the cargo can be picked up, in ISO 8601 UTC format with millisecond precision.
    - `lad` string, date-time: Latest available date the cargo may be delivered, in ISO 8601 UTC format with millisecond precision.
  - `remarks` AircraftMissionRemarksIngest[]: Information related to the planning, load, status, and deployment or dispatch of one aircraft to carry out a mission.
    - `gdssRemarkId` string: Global Decision Support System (GDSS) remark identifier.
    - `type` string: Remark type.
    - `text` string: Text of the remark.
    - `date` string, date-time: Date the remark was published, in ISO 8601 UTC format, with millisecond precision.
    - `user` string: User who published the remark.
    - `itineraryNum` integer: If the remark is sortie specific, this is the number of the sortie it applies to.
  - `hazMat` AirTransportMissionHazMatIngest[]: Collection of Hazardous Material information planned to be associated with this Air Transport Mission.
    - `extHazMatId` string: The hazMat identifier provided by the originating source.
    - `itemName` string: United Nations proper shipping name of the hazardous material according to the Hazardous Materials Regulations issued by the U.S. Department of Transportation.
    - `unNum` string: United Nations number or North America number that identifies hazardous materials according to the Hazardous Materials Regulations issued by the U.S. Department of Transportation.
    - `pieces` integer: Number of pieces of hazardous cargo.
    - `weight` number, double: Total weight of hazardous cargo, including non-explosive parts, in kilograms.
    - `netExpWt` number, double: Net explosive weight of the hazardous material, in kilograms.
    - `classDiv` number, double: Class and division of the hazardous material according to the Hazardous Materials Regulations issued by the U.S. Department of Transportation.
    - `cgc` string: Compatibility group code used to specify the controls for the transportation and storage of hazardous materials according to the Hazardous Materials Regulations issued by the U.S. Department of Transportation.
    - `cgn` string: Comma delimited list of Note IDs for compatibility groups, specific to GDSS systems.
    - `applicableNotes` string: Comma delimited list of Note IDs for Item Class Segregation groups, specific to GDSS systems.
    - `onItin` integer: Itinerary number that identifies where the hazardous material is loaded.
    - `onICAO` string: The International Civil Aviation Organization (ICAO) code of the site where the hazardous material is loaded.
    - `offItin` integer: Itinerary number that identifies where the hazardous material is unloaded.
    - `offICAO` string: The International Civil Aviation Organization (ICAO) code of the site where the hazardous material is unloaded.
    - `planned` string: Flag indicating if hazardous material is associated with this air transport mission. Possible values are P (planned to be associated with the mission) or A (actually associated with the mission). Enum: [P, A].

## Response `204`

Success

## Other responses

- `400`: Bad Request
- `401`: Invalid/Missing User Credentials
- `403`: User Is Not Authorized
- `404`: Item Not Found
- `405`: Method Not Allowed
- `415`: MediaType Unsupported
- `429`: Rate of Requests Exceeds Allowed Limit
- `500`: Internal Server Error

## Changes

> 12 revisions in range; 1 could not be searched.

- **2025-09-26** `45631f9bb3f0`: 1 breaking
  - the `origNetwork` request property's minLength was increased from `0` to `1`
- **2025-04-16** `75f764c843a9`: 2 breaking, 9 warning, 9 info
  - the `requirements/items/ead` request property format changed from no format to `date-time`
  - the `requirements/items/lad` request property format changed from no format to `date-time`
  - the `hazMat/items/classDiv` request property's min was set to `0.00`
  - the `hazMat/items/netExpWt` request property's min was set to `0.00`
  - …16 more

[Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/airtransportmission/:id/put.md)

---

[API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)
