---
title: "POST /filedrop/udl-deconflictset"
method: POST
path: "/filedrop/udl-deconflictset"
tags: ["Mission Ops"]
---

# POST /filedrop/udl-deconflictset

`POST /filedrop/udl-deconflictset`

## Request

- Base URL: `https://unifieddatalibrary.com`
- URL: `https://unifieddatalibrary.com/filedrop/udl-deconflictset`
- Auth: none declared

Service operation to take a single DeconflictSet record as a POST body and ingest into the database. 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

- DeconflictSetIngest: The DeconflictSet service provides access to a set of DeconflictWindows and metadata about those data. A DeconflictWindow describes a time window during which an action, such as target engagement, may either occur or is prohibited from occurring. The DeconflictWindow model includes information about the spatial details for specific target types. A flag is provided to specify whether the window should be associated with taking action (OPEN), or if no action should occur (CLOSED).
  - `id` string: Unique identifier of the record, auto-generated by the system if not provided on create operations.
  - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format.
  - `idLaserDeconflictRequest` string: The id of the LaserDeconflictRequest record used as input in the generation of this DeconflictSet, if applicable.
  - `calculationId` string: The algorithm execution id associated with the generation of this DeconflictSet.
  - `eventType` string: The type of event associated with this DeconflictSet record.
  - `eventStartTime` string, date-time, required: The start time of the event associated with the set of DeconflictWindow records, in ISO 8601 UTC format with millisecond precision.
  - `eventEndTime` string, date-time: The end time of the event associated with the set of DeconflictWindow records, in ISO 8601 UTC format with millisecond precision.
  - `calculationStartTime` string, date-time: The time at which the window calculations started, in ISO 8601 UTC format with millisecond precision.
  - `calculationEndTime` string, date-time: The time at which the window calculations completed, in ISO 8601 UTC format with millisecond precision.
  - `numWindows` integer, required: The number of windows provided by this DeconflictSet record.
  - `errors` string[]: Array of error messages that potentially contain information about the reasons this deconflict response calculation may be inaccurate, or why it failed.
  - `warnings` string[]: Array of warning messages that potentially contain information about the reasons this deconflict response calculation may be inaccurate, or why it failed.
  - `referenceFrame` string: The reference frame of the cartesian orbital states. If the referenceFrame is null it is assumed to be J2000.
  - `deconflictWindows` DeconflictWindowIngest[]: Array of DeconflictWindow records associated with this DeconflictSet.
    - `id` string: Unique identifier of the record, auto-generated by the system if not provided on create operations.
    - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format.
    - `idDeconflictSet` string: Unique identifier of the parent DeconflictSet, auto-generated by the system. The idDeconflictSet is used to identify all individual windows associated with a parent DeconflictSet record.
    - `targetType` string: The target type associated with this window (e.g. VICTIM, EARTH, etc.).
    - `target` string: The target identifier. If the target is a satellite, the target is the satellite/catalog number of the target on-orbit object.
    - `eventType` string: The type of event associated with the window status.
    - `startTime` string, date-time, required: The window start time, in ISO 8601 UTC format with millisecond precision.
    - `stopTime` string, date-time, required: The window stop time, in ISO 8601 UTC format with millisecond precision.
    - `victim` string: The victim identifier associated with this window. If the victim is a satellite, the victim is the satellite/catalog number of the target on-orbit object.
    - `angleOfEntry` number, double: The angle at which the victim enters the target zone in reference to the emitter source location, in degrees.
    - `angleOfExit` number, double: The angle at which the victim exits the target zone in reference to the emitter source location, in degrees.
    - `entryCoords` number[]: The X, Y, Z coordinates of entry, in the reference frame specified by the parent DeconflictSet record, in meters.
    - `exitCoords` number[]: The X, Y, Z coordinates of exit, in the reference frame specified by the parent DeconflictSet record, in meters.
    - `windowType` string: The window status indicating whether possibility of action may occur. In other words, OPEN is akin to a "green light," during which taking action is warranted or authorized (though not necessarily required) over this timeframe, while CLOSED represents a "red light," meaning that absolutely no action is warranted or authorized to take place during this timeframe.
    - `eventStartTime` string, date-time, required: The start time of the event associated with the set of DeconflictWindow records, in ISO 8601 UTC format with millisecond precision.
    - `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.
  - `tags` string[]: Optional array of provider/source specific tags for this data, where each element is no longer than 32 characters, used for implementing data owner conditional access controls to restrict access to the data. Should be left null by data providers unless conditional access controls are coordinated with the UDL team.
  - `transactionId` string: Optional identifier to track a commercial or marketplace transaction executed to produce this data.
  - `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
  - endpoint added

[Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/filedrop/udl-deconflictset/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)