--- title: "POST /udl/manifoldelset" method: POST path: "/udl/manifoldelset" tags: ["Onorbit"] --- # POST /udl/manifoldelset `POST /udl/manifoldelset` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/manifoldelset` - Auth: none declared Service operation to take a single ManifoldElset as a POST body and ingest into the database. A ManifoldElset represents theoretical Keplarian orbital elements belonging to an object of interest's manifold describing a possible/theoretical orbit for an object of interest for tasking purposes. A specific role is required to perform this service operation. Please contact the UDL team for assistance. ## Request body - ManifoldElsetIngest: Theoretical Keplarian orbital elements belonging to an object of interest's manifold describing a possible/theoretical orbit for an object of interest for tasking purposes. - `id` string: Unique identifier of the record, auto-generated by the system. - `idManifold` string, required: Identifier of the parent Manifold record. - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format. - `tmpSatNo` integer, required: A placeholder satellite number and not a true NORAD catalog number. - `epoch` string, date-time, required: Elset epoch time in ISO 8601 UTC format, with microsecond precision. - `meanMotion` number, double: The constant angular speed required for the body to complete one circular orbit in the same amount of time as the actual elliptical orbit with variable speed. Measured in revolutions per day. - `eccentricity` number, double: The orbital eccentricity of an astronomical object is a parameter that determines the amount by which its orbit around another body deviates from a perfect circle. A value of 0 is a circular orbit, values between 0 and 1 form an elliptic orbit, 1 is a parabolic escape orbit, and greater than 1 is a hyperbolic escape orbit. - `inclination` number, double: The angle between the equator and the orbit when looking from the center of the Earth. If the orbit went exactly around the equator from left to right, then the inclination would be 0. The inclination ranges from 0 to 180 degrees. - `raan` number, double: Right ascension of the ascending node, or RAAN is the angle as measured in degrees eastwards (or, as seen from the north, counterclockwise) from the First Point of Aries to the ascending node, which is where the orbit crosses the equator when traveling north. - `argOfPerigee` number, double: The argument of perigee is the angle in degrees formed between the perigee and the ascending node. If the perigee would occur at the ascending node, the argument of perigee would be 0. - `meanAnomaly` number, double: Where the satellite is in its orbital path. The mean anomaly ranges from 0 to 360 degrees. The mean anomaly is referenced to the perigee. If the satellite were at the perigee, the mean anomaly would be 0. - `revNo` integer: The current revolution number. The value is incremented when a satellite crosses the equator on an ascending pass. - `bStar` number, double: The drag term for SGP4 orbital model, used for calculating decay constants for altitude, eccentricity etc, measured in inverse earth radii. - `meanMotionDot` number, double: 1st derivative of the mean motion with respect to time. Units are revolutions per day squared. - `meanMotionDDot` number, double: 2nd derivative of the mean motion with respect to time. Units are revolutions per day cubed. - `semiMajorAxis` number, double: The sum of the periapsis and apoapsis distances divided by two. For circular orbits, the semimajor axis is the distance between the centers of the bodies, not the distance of the bodies from the center of mass. - `period` number, double: Period of the orbit equal to inverse of mean motion. - `apogee` number, double: The Orbit point furthest from the center of the earth in kilometers. - `perigee` number, double: The orbit point nearest to the center of the earth in kilometers. - `line1` string: Read only derived/generated line1 of a legacy TLE (two line element set) format, ignored on create/edit operations. - `line2` string: Read only derived/generated line2 of a legacy TLE (two line element set) format, ignored on create/edit operations. - `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. - `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 `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`: 2 info - api operation id `create_66` 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/manifoldelset/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)