--- title: "PUT /udl/routestats/{id}" method: PUT path: "/udl/routestats/{id}" tags: ["Report and Activity"] --- # PUT /udl/routestats/{id} `PUT /udl/routestats/{id}` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/routestats/{id}` - Auth: none declared Service operation to update a single RouteStats. A specific role is required to perform this service operation. Please contact the UDL team for assistance. ## Path parameters - `id` string, required ## Request body - RouteStatsIngest: General statistics applying to navigation routes utilized by vessels, aircraft, ground vehicles, etc. - `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. - `idSiteStart` string: Unique identifier of the Site at the route's starting location. This ID can be used to obtain additional information on a Site using the 'get by ID' operation (e.g. /udl/site/{id}). For example, the Site object with idSite = abc would be queried as /udl/site/abc. - `idSiteEnd` string: Unique identifier of the Site at the route's end location. This ID can be used to obtain additional information on a Site using the 'get by ID' operation (e.g. /udl/site/{id}). For example, the Site object with idSite = abc would be queried as /udl/site/abc. - `locationStart` string, required: Starting location of the vehicle. - `locationEnd` string, required: End location of the vehicle. - `locationType` string: Type of location used for route start and end points (e.g., ICAO, PORT, etc.). - `distance` number, double: Distance between the departure and arrival locations in the indicated unit of measurement, distUnit. - `distUnit` string: The unit of measurement used for distance in this calculation. - `vehicleCategory` string: The vehicle category that is the subject of this calculation (e.g., AIRCRAFT, CAR, BOAT, etc.). - `vehicleType` string: The vehicle type that is the subject of this calculation (e.g., C-17, F-15, etc.). - `idealDuration` number, double: Estimated ideal travel duration in hours for the full distance using the indicated vehicle type. The field "idealDesc" should be used to describe the ideal travel route. - `idealDesc` string: Description of the portion of travel used to estimate the value of the idealDuration field. - `partialDuration` number, double: Estimated ideal travel duration in hours for a partial distance using the indicated vehicle type. The field "partialDesc" should be used to specify the intended portion of travel. - `partialDesc` string: Description of the portion of travel used to estimate the value of the partialDuration field. - `avgDuration` number, double: Average travel duration for the indicated distance and type of vehicle in hours. - `minDuration` number, double: Minimum travel duration for the indicated distance and type of vehicle in hours. - `maxDuration` number, double: Maximum travel duration for the indicated distance and type of vehicle in hours. - `avgSpeed` number, double: Average speed during travel in the indicated unit of measurement, speedUnit. - `minSpeed` number, double: Minimum speed during travel in the indicated unit of measurement, speedUnit. - `maxSpeed` number, double: Maximum speed during travel in the indicated unit of measurement, speedUnit. - `speedUnit` string: The unit of measurement used for speed in this calculation. - `timePeriod` string: The time period this data was collected. - `firstPt` string, date-time: Date of the first data point used in this calculation, in ISO8601 UTC format with millisecond precision. - `lastPt` string, date-time: Date of the last data point used in this calculation, in ISO8601 UTC format with millisecond precision. - `dataPtsUsed` integer: The number of data points used in this travel duration calculation. - `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. - `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. ## 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-04-16** `75f764c843a9`: 1 info - endpoint added [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/routestats/: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)