--- title: "PUT /udl/onorbitevent/{id}" method: PUT path: "/udl/onorbitevent/{id}" tags: ["Onorbit"] --- # PUT /udl/onorbitevent/{id} `PUT /udl/onorbitevent/{id}` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/onorbitevent/{id}` - Auth: none declared Service operation to update a single OnorbitEvent. An OnorbitEvent is an event associated with a particular on-orbit spacecraft including insurance related losses, anomalies and incidents. A specific role is required to perform this service operation. Please contact the UDL team for assistance. ## Path parameters - `id` string, required ## Request body - OnorbitEventIngest - `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. - `derivedFrom` string: The sources or SCG references from which the classification of this data is derived. - `declassificationDate` string, date-time: The declassification date of this data, in ISO 8601 UTC format. - `declassificationString` string: Declassification string of this data. - `idOnOrbit` string: Unique identifier of the on-orbit object for this event. - `satNo` integer: Satellite/Catalog number of the target on-orbit object. - `origObjectId` string: Original object ID or Catalog Number provided by source (may not map to an existing idOnOrbit in UDL). - `eventTime` string, date-time, required: Date/Time of the event. See eventTimeNotes for remarks on the accuracy of the date time. - `eventTimeNotes` string: Notes/remarks on the validity/accuracy of the eventTime. - `operatorOrgId` string: Organization ID of the operator of the on-orbit spacecraft at the time of the event. - `ownerOrgId` string: Organization ID of the owner of the on-orbit spacecraft at the time of the event. - `lesseeOrgId` string: Unique identifier of the organization which leases this on-orbit spacecraft. - `operatedOnBehalfOfOrgId` string: Unique identifier of the organization on whose behalf the on-orbit spacecraft is operated. - `geoPosition` number, double: GEO position longitude at event time if applicable. Negative values are west. - `planeSlot` string: GEO plane slot of the spacecraft at event time. - `planeNumber` string: GEO slot plane number/designator of the spacecraft at event time. - `positionStatus` string: Position status of the spacecraft at event time (e.g. Stable, Drifting/Tumbling, etc). - `untilTime` string, date-time: Maximum validity time of the event. - `officialLossDate` string, date-time: Date time of official loss of the spacecraft. - `netAmount` number, double: Net amount of the insurance claim for the event, in USD. - `underlyingCause` string: Underlying cause of the event. - `capabilityLoss` number, double: Spacecraft capability loss incurred, as a fraction of 1. - `capacityLoss` number, double: Spacecraft capacity loss incurred, as a fraction of 1. - `insuranceLoss` number, double: Insurance loss incurred, as a fraction of 1. - `thirdPartyInsuranceLoss` number, double: Insurance loss incurred by 3rd party insurance, in USD. - `injured` integer: Number of humans injured in the event. - `killed` integer: Number of humans killed in the event. - `lifeLost` number, double: Spacecraft life lost due to the event as a percent/fraction of 1. - `ageAtEvent` number, double: Spacecraft age at the event in years. - `achievedFlightPhase` string: Achieved phase of flight prior to the event. - `occurrenceFlightPhase` string: Phase of flight during which the event occurred. - `stageAtFault` string: Faulty stage of flight for the event. - `equipmentAtFault` string: Equipment on the spacecraft which caused the event. - `equipmentTypeAtFault` string: Type of the equipment on the spacecraft which caused the event. - `equipmentPartAtFault` string: Specific part of the equipment on the spacecraft which caused the event. - `consequentialEquipmentFailure` string: Additional equipment which failed as a result of faulty equipment on the spacecraft during the event. - `inclined` boolean: Boolean indicating if the spacecraft is inclined. - `description` string: Notes/description of the event. - `remarks` string: Additional remarks on the event description. - `insuranceLossNotes` string: Additional insurance notes if the event is an official loss. - `capabilityLossNotes` string: Notes on capability loss at the time of event. - `insuranceCarriedNotes` string: Additional insurance notes on coverages at the time of event. - `equipmentCausingLossNotes` string: Additional notes on the equipment causing the event/loss. - `eventType` string: The type of on-orbit event being reported. - `eventResult` string: The result of the reported event. - `objectStatus` string: The status of the on-orbit object. - `satellitePosition` string: Description of the satellite orbital position or regime. - `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. - `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. - `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`: 2 info - api operation id `edit_48` 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/onorbitevent/: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)