---
title: "POST /udl/isrcollection/createBulk"
method: POST
path: "/udl/isrcollection/createBulk"
tags: ["Sensor Tasking"]
---

# POST /udl/isrcollection/createBulk

`POST /udl/isrcollection/createBulk`

## Request

- Base URL: `https://unifieddatalibrary.com`
- URL: `https://unifieddatalibrary.com/udl/isrcollection/createBulk`
- Auth: none declared

Service operation intended for initial integration only, to take a list of ISRCollection records as a POST body and ingest into the database. This operation is not intended to be used for automated feeds into UDL. Data providers should contact the UDL team for specific role assignments and for instructions on setting up a permanent feed through an alternate mechanism.

## Request body

- ISRCollectionIngest[]
  - `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.
  - `idexVersion` integer: Version of the IDEX software the request came from for compatibility.
  - `name` string: Human readable Mission Name.
  - `missionId` string: Mission Identifier.
  - `missionAOR` string: Designation of mission Area Of Responsibility.
  - `missionPrimaryIntelDiscipline` string: Primary type of intelligence to be collected during the mission.
  - `missionPrimarySubCategory` string: Sub category of primary intelligence to be collected.
  - `missionSecondaryIntelDiscipline` string: Type of intelligence to be collected second.
  - `missionSecondarySubCategory` string: Mission sub category for secondary intelligence discipline to be collected.
  - `missionRole` string: What is the primary objective(Role) of this mission.
  - `missionOperation` string: Mission operation name.
  - `missionPriority` integer: Mission Priority (1-n).
  - `missionSupportedUnit` string: Name of the Supporting unit/Location that is performing this mission.
  - `missionEmphasis` string: Text version of what we are emphasizing in this mission.
  - `missionStartPointLat` number, double: WGS-84 latitude of the start position, in degrees. -90 to 90 degrees (negative values south of equator).
  - `missionStartPointLong` number, double: WGS-84 longitude of the start position, in degrees. -180 to 180 degrees (negative values west of Prime Meridian).
  - `missionCollectionArea` string: Mission geographical collection area.
  - `missionJoa` string: Joint Operations Area.
  - `missionSyncMatrixBin` string: A synchronization matrix is used to organize the logistics synchronization process during a mission.
  - `missionCountry` string: Country code of the mission. A Country may represent countries, multi-national consortiums, and international organizations.
  - `missionRegion` string: Region of the mission.
  - `missionSubRegion` string: Subregion of the mission.
  - `collectionRequirements` ISRCollectionRequirementsIngest[]: Mission desired collection requirements.
    - `id` string: Collection Requirement Unique Identifier.
    - `hash` string: Encryption hashing algorithm.
    - `type` string: Type collection this requirement applies to.
    - `cridNumbers` string: Collection Requirement Unique Identifier.
    - `priority` number, double: 1-n priority for this collection requirement.
    - `recordId` string: Record id.
    - `reconSurvey` string: Reconnaissance Survey information the operator needs.
    - `intelDiscipline` string: Primary type of intelligence to be collected for this requirement.
    - `secondary` boolean: Sub category of primary intelligence to be collected for this requirement.
    - `emphasized` boolean: Is this collection requirement an emphasized/critical requirement.
    - `isPrismCr` boolean: Is this collection request for the Prism system?.
    - `start` string, date-time: Start time for this requirement, should be within the mission time window.
    - `stop` string, date-time: Stop time for this requirement, should be within the mission time window.
    - `operation` string: Human readable name for this operation.
    - `supportedUnit` string: The name of the military unit that this assigned collection requirement will support.
    - `country` string: Country code of the collection requirement. A Country may represent countries, multi-national consortiums, and international organizations.
    - `region` string: Region of the collection requirement.
    - `subregion` string: Subregion of the collection requirement.
    - `specialComGuidance` string: Free text field for the user to specify special instructions needed for this collection.
    - `criticalTimes` ISRCollectionCriticalTimesIngest
      - `earliestImagingTime` string, date-time, required: Critical start time to collect an image for this requirement.
      - `latestImagingTime` string, date-time, required: Critical stop time to collect an image for this requirement.
    - `exploitationRequirement` ISRCollectionExploitationRequirementIngest
      - `id` string: Exploitation requirement id.
      - `amplification` string: Amplifying data for the exploitation requirement.
      - `reportingCriteria` string: The reporting criteria of the collection requirement.
      - `dissemination` string: List of e-mails to disseminate collection verification information.
      - `eei` string: Essential Elements of Information.
      - `poc` ISRCollectionPOCIngest
        - `id` string: Unique identifier of the collection requirement POC.
        - `name` string: Name of the POC.
        - `callsign` string: Callsign of the POC.
        - `unit` string: Unit the POC belongs to.
        - `email` string: Email address of the POC.
        - `phone` string: Phone number of the POC.
        - `radioFrequency` number, double: Radio Frequency the POC is on.
        - `chatSystem` string: Chat system the POC is accessing.
        - `chatName` string: Chat name of the POC.
        - `notes` string: Amplifying notes about the POC.
    - `targetList` string[]: Array of POI Id's for the targets being tasked.
  - `transit` ISRCollectionTransitIngest[]: Object for data dissemination.
    - `id` string: Transit Unique Identifier.
    - `base` string: Military Base to transmit the dissemination of this data.
    - `duration` number, double: Length of mission in milliseconds.
  - `taskings` ISRCollectionTaskingsIngest[]: Individual taskings to complete the mission.
    - `id` string: Tasking Unique Identifier.
    - `type` 'Deliberate' | 'Dynamic' | 'Training' | 'Transit': Type of tasking.
    - `collectionType` 'Simultaneous' | 'Sequential' | 'Operationally' | 'Driven' | 'Priority' | 'Order': Type of collection tasked.
    - `taskingAOR` string: Human readable definition of this taskings Area Of Responsibility.
    - `eightLine` string: Eight line.
    - `taskingPrimaryIntelDiscipline` string: Primary type of intelligence to be collected during the mission.
    - `taskingPrimarySubCategory` string: Sub category of primary intelligence to be collected.
    - `taskingSecondaryIntelDiscipline` string: Type of tasking intelligence to be collected second.
    - `taskingSecondarySubCategory` string: Mission sub category for secondary intelligence discipline to be collected.
    - `taskingRole` string: What is the primary objective (role) of this task.
    - `taskingOperation` string: Tasking operation name.
    - `taskingPriority` number, double: Tasking Priority (1-n).
    - `taskingSupportedUnit` string: Military Base to transmit the dissemination of this data.
    - `taskingEmphasis` string: Tasking emphasis.
    - `taskingRetaskTime` string, date-time: Time of retasking, in ISO 8601 UTC format.
    - `taskingStartPointLat` number, double: WGS-84 latitude of the start position, in degrees. -90 to 90 degrees (negative values south of equator).
    - `taskingStartPointLong` number, double: WGS-84 longitude of the start position, in degrees. -180 to 180 degrees (negative values west of Prime Meridian).
    - `taskingCollectionArea` string: Tasking geographical collection area.
    - `taskingJoa` string: Joint Operations Area.
    - `taskingSyncMatrixBin` string: A synchronization matrix is used to organize the logistics synchronization process during a mission.
    - `taskingCountry` string: Country code of the tasking. A Country may represent countries, multi-national consortiums, and international organizations.
    - `taskingRegion` string: Region of the tasking.
    - `taskingSubRegion` string: Subregion of the tasking.
    - `sroTrack` string: Value of the Sensitive Reconnaissance Operations Track.
    - `specialComGuidance` string: Free text field for the user to specify special instructions needed for this collection.
    - `collectionPeriods` ISRCollectionPeriodsIngest
      - `planned` ISRCollectionPlannedIngest
        - `start` string, date-time: Start time of collection, in ISO 8601 UTC format.
        - `stop` string, date-time: Stop time of collection, in ISO 8601 UTC format.
        - `additional` ISRCollectionAdditionalIngest[]: Additional start and stop for the collection.
          - `id` string: Unique Identifier of additional collection period.
          - `start` string, date-time: Start time of collection, in ISO 8601 UTC format.
          - `stop` string, date-time: Stop time of collection, in ISO 8601 UTC format.
      - `actual` ISRCollectionActualIngest[]: Actual start and stop for the collection.
        - `id` string: Unique Identifier of actual collection period for historical archive.
        - `start` string, date-time: Start time the collection actually occurred, in ISO 8601 UTC format.
        - `stop` string, date-time: Stop time the collection actually occurred, in ISO 8601 UTC format.
    - `taskingCollectionRequirements` ISRCollectionRequirementsIngest[]: Tasking desired collection requirements.
      - `id` string: Collection Requirement Unique Identifier.
      - `hash` string: Encryption hashing algorithm.
      - `type` string: Type collection this requirement applies to.
      - `cridNumbers` string: Collection Requirement Unique Identifier.
      - `priority` number, double: 1-n priority for this collection requirement.
      - `recordId` string: Record id.
      - `reconSurvey` string: Reconnaissance Survey information the operator needs.
      - `intelDiscipline` string: Primary type of intelligence to be collected for this requirement.
      - `secondary` boolean: Sub category of primary intelligence to be collected for this requirement.
      - `emphasized` boolean: Is this collection requirement an emphasized/critical requirement.
      - `isPrismCr` boolean: Is this collection request for the Prism system?.
      - `start` string, date-time: Start time for this requirement, should be within the mission time window.
      - `stop` string, date-time: Stop time for this requirement, should be within the mission time window.
      - `operation` string: Human readable name for this operation.
      - `supportedUnit` string: The name of the military unit that this assigned collection requirement will support.
      - `country` string: Country code of the collection requirement. A Country may represent countries, multi-national consortiums, and international organizations.
      - `region` string: Region of the collection requirement.
      - `subregion` string: Subregion of the collection requirement.
      - `specialComGuidance` string: Free text field for the user to specify special instructions needed for this collection.
      - `criticalTimes` ISRCollectionCriticalTimesIngest
        - `earliestImagingTime` string, date-time, required: Critical start time to collect an image for this requirement.
        - `latestImagingTime` string, date-time, required: Critical stop time to collect an image for this requirement.
      - `exploitationRequirement` ISRCollectionExploitationRequirementIngest
        - `id` string: Exploitation requirement id.
        - `amplification` string: Amplifying data for the exploitation requirement.
        - `reportingCriteria` string: The reporting criteria of the collection requirement.
        - `dissemination` string: List of e-mails to disseminate collection verification information.
        - `eei` string: Essential Elements of Information.
        - `poc` ISRCollectionPOCIngest
          - `id` string: Unique identifier of the collection requirement POC.
          - `name` string: Name of the POC.
          - `callsign` string: Callsign of the POC.
          - `unit` string: Unit the POC belongs to.
          - `email` string: Email address of the POC.
          - `phone` string: Phone number of the POC.
          - `radioFrequency` number, double: Radio Frequency the POC is on.
          - `chatSystem` string: Chat system the POC is accessing.
          - `chatName` string: Chat name of the POC.
          - `notes` string: Amplifying notes about the POC.
      - `targetList` string[]: Array of POI Id's for the targets being tasked.
  - `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.
  - `updatedAt` string, date-time: Time the row was updated in the database, auto-populated by the system, example = 2018-01-01T16:00:00.123Z.
  - `updatedBy` string: Application user who updated 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 `204`

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`: 4 info
  - api operation id `createBulk_6` removed and replaced with ``
  - the endpoint scheme security `BasicAuth` was removed from the API
  - the `items/collectionRequirements/items/targetList/items/` request property's minLength was decreased from `1` to `0`
  - the `items/taskings/items/taskingCollectionRequirements/items/targetList/items/` request property's minLength was decreased from `1` to `0`

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