--- title: "POST /udl/airtaskingorder" method: POST path: "/udl/airtaskingorder" tags: ["AirOperations"] --- # POST /udl/airtaskingorder `POST /udl/airtaskingorder` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/airtaskingorder` - Auth: none declared Service operation to take a single airtaskingorder record as a POST body and ingest into the database. A specific role is required to perform this service operation. Please contact the UDL team for assistance. ## Request body - AirTaskingOrderIngest: Beta Version Air Tasking Order: The ATO is used to task air missions, assign cross force tasking as well as intraservice tasking. - `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. - `opExerName` string, required: Specifies the unique operation or exercise name, nickname, or codeword assigned to a joint exercise or operation plan. - `msgOriginator` string: The identifier of the originator of the message. - `msgSN` string: The unique message identifier sequentially assigned by the originator. - `msgMonth` string: The month in which the message originated. - `msgQualifier` string: The qualifier which caveats the message status. - `ackReqInd` string: The indicator specifying an affirmative or a negatice condition for this message. - `ackUnitInstructions` string: Specifies textual data amplifying the data contained in the acknowledgement requirement indicator (ackRedInd) field or the unit required to acknowledge. - `beginTs` string, date-time, required: The effective begin time for this ATO in ISO 8601 UTC format with millisecond precision. - `endTs` string, date-time: The effective end time for this ATO in ISO 8601 UTC format with millisecond precision. - `genText` GenTextIngest[]: A collection that details special instructions, important information, guidance, and amplifying information regarding this ATO. - `textInd` string: The indicator for the general text block. Examples include "OPENING REMARKS" and "GENERAL SPINS INFORMATION". - `text` string: The free text that describes the information specific to the text indicator. - `acMsnTasking` AircraftMissionTaskingIngest[]: A collection that specifies the tasked country, tasked service, unit and mission level tasking for this ATO. - `countryCode` string, required: The country code responsible for conducting this aircraft mission tasking for the exercise or operation. - `taskedService` string, required: The service tasked with conducting this aircraft mission tasking for the exercise or operation. - `unitDesignator` string, required: The designator of the unit that is tasked to perform this aircraft mission tasking. - `unitLocName` string: The tasked units location expressed as an ICAO or a place name. - `resMsnInd` string, char: An indicator of whether a mission is or will be a residual mission. - `amcMsnNum` string: The AMC number assigned to identify one aircraft from another. - `pkgId` string: The identifier for the composite set of missions for this operation/exercise. - `msnCommander` string: The commander responsible for the planning and execution of the forces necessary to achieve desired objectives. - `msnNum` string: The mission number assigned to this mission. - `priMsnType` string: The code for the preferred type or designator for a tasked air mission. - `secMsnType` string: The code for the alternative type of a tasked air mission. - `alertStatus` integer: The readiness status expressed in time (minutes) for an aircraft to be airborne after the launch order is received or the time required for a missile unit to assume battle stations. - `depLocName` string: The location or name specified for the departure of the tasked air mission. - `depLocUTM` string: The departure location specified in UTM (100 meter) coordinates for the tasked air mission. - `depLocLat` number, double: WGS-84 latitude of the departure location, in degrees. -90 to 90 degrees (negative values south of equator) for this tasked air mission. - `depLocLon` number, double: WGS-84 longitude of the departure location, in degrees. -180 to 180 degrees (negative values west of Prime Meridian) for this tasked air mission. - `depTime` string, date-time: The time of departure for the tasked air mission in ISO8601 UTC format with millisecond precision. - `rcvyLocName` string[]: An array of locations specified for the recovery of the tasked air mission represented by varying formats. - `rcvyLocUTM` string[]: An array of recovery locations specified in UTM (100 meter) coordinates for the tasked air mission. - `rcvyLocLat` number[]: An array of WGS-84 latitude of the recovery locations, in degrees. -90 to 90 degrees (negative values south of equator) for this tasked air mission. - `rcvyLocLon` number[]: An array of WGS-84 longitude of the recovery locations, in degrees. -180 to 180 degrees (negative values west of Prime Meridian) for this tasked air mission. - `rcvyTime` string[]: An array of recovery times for the tasked air mission in ISO8601 UTC format with millisecond precision. - `indACTasking` IndividualAircraftTaskingIngest[]: A collection of the individual aircraft assigned to this aircraft mission tasking. - `numAcft` integer: The number of aircraft participating in this mission. - `acftType` string, required: The type and model number for the aircraft. The field may specify a value of an aircraft not yet assigned an aircraft code contained in the aircraft codes list. - `callSign` string: The call sign assigned to this mission aircraft. - `priConfigCode` string: The code that indicates the ordinance mix carried on this mission aircraft. - `secConfigCode` string: The code for the secondary ordinance mix carried on this mission aircraft. - `link16CallSign` string: The Link 16 abbreviated call sign assigned to the ACA. This is normally the first and last letter and the last two numbers of the call sign. - `tacanChan` integer: The TACAN channel assigned to this mission aircraft. - `juAddress` integer[]: An optional array of link 16 octal track numbers assigned as the primary JTIDS Unit (JU) address for the mission aircraft. - `iffSifMode1Code` string: The mode 1 and code of the Identification Friend or FOE (IFF) or Selective Identification Feature (SIF). - `iffSifMode2Code` string: The mode 2 and code of the Identification Friend or FOE (IFF) or Selective Identification Feature (SIF). - `iffSifMode3Code` string: The mode 3 and code of the Identification Friend or FOE (IFF) or Selective Identification Feature (SIF). - `acMsnLocSeg` AircraftMissionLocationTaskingIngest[]: A collection of aircraft mission location information for this aircraft mission tasking. - `startTime` string, date-time, required: The start time of this mission in ISO 8601 UTC format with millisecond precision. - `endTime` string, date-time: The end time of this mission in ISO 8601 UTC format with millisecond precision. - `msnLocName` string: The name that identifies the location at which this mission is to be performed. This can be the name of a general target area, orbit, cap point, station, etc. - `alt` integer: The altitude for this mission represented as hundreds of feet above MSL. - `airMsnPri` string: The code for the priority assigned to this mission. - `areaGeoRad` integer: The radius of the circle around the location being reported in feet. - `msnLocPtName` string: The location name for this mission. - `msnLocPtLat` number, double: WGS-84 latitude of the mission location, in degrees. -90 to 90 degrees (negative values south of equator) for this tasked air mission. - `msnLocPtLon` number, double: WGS-84 longitude of the mission location, in degrees. -180 to 180 degrees (negative values west of Prime Meridian) for this tasked air mission. - `msnLocPtBarT` string: The alpha-numeric specified location for this mission specified as a bearing angle in degrees relative to true north and a range in nautical miles (NM). - `navalFltOps` NavalFlightOperationsIngest[]: A collection that specifies the naval flight operations for this ATO. - `shipName` string, required: The name of a ship or maritime vessel. Specify UNKNOWN if name is not known. - `fltOpStart` string, date-time: The time when flight operations begin in ISO8601 UTC format with millisecond precision. - `fltOpStop` string, date-time: The time when flight operations end in ISO8601 UTC format with millisecond precision. - `schdLaunchRcvyTime` string[]: An array of times at which an aircraft will be launched and/or recovered in ISO8601 UTC format with millisecond precision. - `createdAt` string, date-time: Time the row was created in the database. - `createdBy` string: Application user who created the row in the database. - `source` string, required: Source of the data. - `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. - `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. - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system. - `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. ## Response `201` Success ## Other responses - `400`: Bad Request - `401`: Invalid/Missing User Credentials - `403`: User Is Not Authorized - `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`: 1 breaking, 2 info - the `acMsnTasking/items/resMsnInd` request property format changed from no format to `char` - api operation id `create_2` removed and replaced with `` - the endpoint scheme security `BasicAuth` was removed from the API [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/airtaskingorder/post.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)