--- title: "POST /filedrop/udl-globalatmosphericmodel" method: POST path: "/filedrop/udl-globalatmosphericmodel" tags: ["Models and Simulations"] --- # POST /filedrop/udl-globalatmosphericmodel `POST /filedrop/udl-globalatmosphericmodel` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/filedrop/udl-globalatmosphericmodel` - Auth: none declared Upload a file with its metadata. The request body requires a zip file containing exactly two files:\ 1\) A file with the `.json` file extension whose content conforms to the `GlobalAtmosphericModel_Ingest` schema.\ 2\) A file with the `.geojson` file extension. The JSON and GEOJSON files will be associated with each other other via the `id` field. Query the metadata via `GET /udl/globalatmosphericmodel` and use `GET /udl/globalatmosphericmodel/getFile/{id}` to retrieve the compressed GEOJSON file as `.gz` extension. This operation only accepts application/zip media. The application/json request body is documented to provide a convenient reference to the ingest schema. This operation is intended to be used for automated feeds into UDL. A specific role is required to perform this service operation. Please contact the UDL team for assistance. ## Request body - GlobalAtmosphericModelIngest: The GlobalAtmosphericModel service provides atmospheric model output data for use in space situational awareness such as the Global Total Electron Content (2D) data, Global Total Electron Density (3D) data, 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. - `ts` string, date-time, required: Target time of the model in ISO 8601 UTC format with millisecond precision. - `type` string, required: Type of data associated with this record (e.g. Global Total Electron Density, Global Total Electron Content). - `reportTime` string, date-time: The time that this record was created, in ISO 8601 UTC format with millisecond precision. - `dataSourceIdentifier` string: A unique identification code or label assigned to a particular source from which atmospheric data originates. - `state` string: State value indicating whether the values in this record are PREDICTED or OBSERVED. - `cadence` integer: Model execution cadence, in minutes. - `startLat` number, double: WGS-84 starting latitude of model output, in degrees. -90 to 90 degrees (negative values south of equator). - `endLat` number, double: WGS-84 ending latitude of model output, in degrees. -90 to 90 degrees (negative values south of equator). - `stepLat` number, double: Separation in latitude between subsequent model outputs, in degrees. - `numLat` integer: Number of latitude points. - `startLon` number, double: WGS-84 starting longitude of model output, in degrees. -180 to 180 degrees (negative values west of Prime Meridian). - `endLon` number, double: WGS-84 ending longitude of model output, in degrees. -180 to 180 degrees (negative values west of Prime Meridian). - `stepLon` number, double: Separation in longitude between subsequent model outputs, in degrees. - `numLon` integer: Number of longitude points. - `startAlt` number, double: Starting altitude of model outputs, in kilometers. - `endAlt` number, double: Ending altitude of model outputs, in kilometers. - `numAlt` integer: Number of altitude points. - `filename` string: The file name of the uploaded file. - `filesize` integer: The uploaded file size, in bytes. The maximum file size for this service is 104857600 bytes (100MB). Files exceeding the maximum size will be rejected. - `checksumValue` string: MD5 value of the data file. If not provided, the ingest/create operation will automatically generate the value. - `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. - `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 `202` Accepted ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `429`: Rate of Requests Exceeds Allowed Limit - `500`: Internal Server Error ## Changes > 12 revisions in range; 1 could not be searched. - **2026-04-09** `bd17bc53681e`: 1 info - added the non-success response with the status `429` - **2025-09-26** `45631f9bb3f0`: 1 info - added the new optional request property `dataSourceIdentifier` - **2025-04-16** `75f764c843a9`: 1 info - endpoint added [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/filedrop/udl-globalatmosphericmodel/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)