--- title: "POST /udl/aviationriskmanagement" method: POST path: "/udl/aviationriskmanagement" tags: ["AirOperations"] --- # POST /udl/aviationriskmanagement `POST /udl/aviationriskmanagement` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/aviationriskmanagement` - Auth: none declared Service operation to take a single Aviation Risk Management 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 - AviationRiskManagementIngest: Aviation Risk Management is used to identify, evaluate, and track risks when mission planning by accounting for factors such as crew fatigue and mission complexity. - `id` string: Unique identifier of the record, auto-generated by the system if not provided on create operations. - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format. - `idMission` string, required: The unique identifier of the mission to which this risk management record is assigned. - `extMissionId` string: Optional mission ID from external systems. This field has no meaning within UDL and is provided as a convenience for systems that require tracking of an internal system generated ID. - `missionNumber` string: The mission number of the mission associated with this record. - `unitId` string: Identifier for the unit which this risk management record is evaluated. - `orgId` string: Identifier for the organization which this risk management record is evaluated. - `aviationRiskManagementWorksheetRecord` AviationRiskManagementWorksheetRecordIngest[]: Collection of Aviation Risk Management Worksheet Records. - `extRecordId` string: Optional identifier of the worksheet record provided by the data source. This field has no meaning within UDL and is provided as a convenience for systems that require tracking of an internal system generated ID. - `userId` string: User identifier associated to the worksheet record. - `itinerary` string: Sequential order of itinerary locations associated for the mission. - `totalScore` integer: Total score for the worksheet record as defined by the data source. Larger values indicate a higher risk level. For example, values between 0-10 may indicate a low risk level, where values greater then 40 indicate a severe risk level. - `tierNumber` integer: Tier number which the mission is being scored as determined by the data source. For example, Tier 1 may indicate mission planners, Tier 2 may indicate operations personnel, Tier 3 may indicate squadron leadership, and Tier 4 may indicate the aircrew. - `submissionDate` string, date-time: Timestamp the worksheet record was submitted, in ISO 8601 UTC format with millisecond precision. - `missionDate` string, date, required: Date of the mission in ISO 8601 date-only format (YYYY-MM-DD). - `lastUpdatedAt` string, date-time: Timestamp the worksheet record was updated, in ISO 8601 UTC format with millisecond precision. - `aircraftMDS` string: The aircraft Model Design Series (MDS) designation (e.g. E-2C HAWKEYE, F-15 EAGLE, KC-130 HERCULES, etc.) of the aircraft associated with this risk management worksheet record. Intended as, but not constrained to, MIL-STD-6016 environment dependent specific type designations. - `severityLevel` integer: Numeric assignment for the worksheet record severity. 0 - LOW; 1 - MODERATE; 2 - HIGH; 3 - SEVERE. - `approvalPending` boolean: Flag indicating the worksheet record is pending approval. - `approved` boolean: Flag indicating the worksheet record is approved. - `dispositionComments` string: Comment(s) explaining why the worksheet record has been approved or disapproved. - `remarks` string: Remarks and/or comments regarding the worksheet record. - `aviationRiskManagementWorksheetScore` AviationRiskManagementWorksheetScoreIngest[]: Collection of Aviation Risk Management worksheet record scores. - `extScoreId` string: Optional identifier of the worksheet record score provided by the data source. This field has no meaning within UDL and is provided as a convenience for systems that require tracking of an internal system generated ID. - `score` integer: Score of the worksheet record risk factor. Value ranges from 0 to 3, where a value of 0 indicates a low and a value of 3 indicates severe. A value of -1 indicates no score. - `approvedCode` integer: Numeric assignment used to determine score approval. 0 - APPROVAL PENDING (used when score value is 2 or 3); 1 - APPROVED (used when score value is 2 or 3); 2 - DISAPPROVED. - `approvedBy` string: Name of the individual who approved or disapproved of the score. - `approvalDate` string, date-time: Timestamp the worksheet record score was approval or disapproval, in ISO 8601 UTC format with millisecond precision. - `riskCategory` string: The category of the risk factor. - `riskKey` string: Code or identifier of the risk factor category as defined by the data source. - `riskName` string: Name of the risk factor. - `riskDescription` string: Description of the risk factor. - `scoreRemark` string: Remarks and/or comments regarding the worksheet score. - `aviationRiskManagementSortie` AviationRiskManagementSortieIngest[]: Collection of aviation risk management worksheet record score aircraft sorties. - `idSortie` string: Unique identifier of an associated Aircraft Sortie that is assigned to this risk management record. - `extSortieId` string: Optional aircraft sortie ID from external systems. This field has no meaning within UDL and is provided as a convenience for systems that require tracking of an internal system generated ID. - `legNum` integer: The leg number of the sortie. - `sortieScore` integer: The score of the associated aircraft sortie as defined by the data source. Value ranges from 0 to 3, where a value of 0 indicates a low and a value of 3 indicates severe. A value of -1 indicates no score. - `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. - `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-04-16** `75f764c843a9`: 1 info - endpoint added [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/aviationriskmanagement/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)