--- title: "POST /udl/objectofinterest" method: POST path: "/udl/objectofinterest" tags: ["Onorbit"] --- # POST /udl/objectofinterest `POST /udl/objectofinterest` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/objectofinterest` - Auth: none declared Service operation to take a single ObjectOfInterest 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 - ObjectOfInterestIngest: OnOrbit objects of interest, which include information about the last known state of the object. - `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. - `idOnOrbit` string, required: UUID of the parent Onorbit record. - `satNo` integer: Satellite/Catalog number of the target on-orbit object. - `name` string: Unique name of the object of interest event. - `sensorTaskingStartTime` string, date-time, required: Sensor tasking start time for object of interest. - `sensorTaskingStopTime` string, date-time: Sensor tasking stop time for object of interest. - `priority` integer: Priority of the object of interest as an integer (1=highest priority). - `status` string: Status of the object of interest event (e.g. OPEN, CLOSED, CANCELLED). - `statusDate` string, date-time, required: Time of last status change of the object of interest event. - `description` string: Description of the object of interest event. - `lastObTime` string, date-time: Last reported observation time in ISO 8601 UTC time, with microsecond precision. - `missedObTime` string, date-time: The time at which an attempted observation of the object of interest noticed it was missing, in ISO 8601 UTC time, with microsecond precision. - `deltaVs` number[]: Possible delta V applications for the object of interest, in km/sec. - `deltaTs` number[]: Possible delta time applications for the object of interest, in seconds. - `svEpoch` string, date-time: Last reported state vector epoch time in ISO 8601 UTC time, with microsecond precision. - `x` number, double: Last reported x position of the object in km, in J2000 coordinates. - `y` number, double: Last reported y position of the object in km, in J2000 coordinates. - `z` number, double: Last reported z position of the object in km, in J2000 coordinates. - `xvel` number, double: Last reported x velocity of the object in km/sec, in J2000 coordinates. - `yvel` number, double: Last reported y velocity of the object in km/sec, in J2000 coordinates. - `zvel` number, double: Last reported z velocity of the object in km/sec, in J2000 coordinates. - `elsetEpoch` string, date-time: Last reported elset epoch time in ISO 8601 UTC time, with microsecond precision. - `meanMotion` number, double: Last reported mean motion of the object. Mean motion is the angular speed required for a body to complete one orbit, assuming constant speed in a circular orbit which completes in the same time as the variable speed, elliptical orbit of the actual body. Measured in revolutions per day. - `eccentricity` number, double: Last reported eccentricity of the object. 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: Last reported inclination of the object. Inclination is 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: Last reported raan. 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: Last reported argument of perigee. 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: Last reported meanAnomaly. Mean anomoly is 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 last reported revolution number. The value is incremented when a satellite crosses the equator on an ascending pass. - `bStar` number, double: Last reported drag term for SGP4 orbital model, used for calculating decay constants for altitude, eccentricity etc, measured in inverse earth radii. - `meanMotionDot` number, double: Last reported 1st derivative of the mean motion with respect to time. Units are revolutions per day squared. - `meanMotionDDot` number, double: Last reported 2nd derivative of the mean motion with respect to time. Units are revolutions per day cubed. - `semiMajorAxis` number, double: Last reported semi major axis, which is 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: Last reported orbit period. Period of the orbit is equal to inverse of mean motion. - `apogee` number, double: Last reported apogee. The Orbit point furthest from the center of the earth in kilometers. - `perigee` number, double: Last reported perigee. The orbit point nearest to the center of the earth in kilometers. - `affectedObjects` string[]: Optional array of Onorbit IDs (idOnOrbit) representing satellites potentially affected by this object of interest. - `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. - `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`: 2 info - api operation id `create_73` 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/objectofinterest/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)