---
title: "Create Order"
method: POST
path: "/pipelines"
tags: ["legacyPipelines"]
---

# Create Order

`POST /pipelines`

Create a new imagery order. Specify the data source, area of interest, time interval, and processing parameters. The order will be queued for processing and you will receive notifications as it progresses through various stages.

## Request body

- PipelineCreateBody
  - `name` string — Optional parameter allows you to give your pipeline an identifying name
  - `start_date` string, date — Start date of your collection period
  - `end_date` string, date — End date of your collection period
  - `budget_per_km2` number — Control price by setting the amount you are willing to pay per square kilometre. Use this OR max_cost
  - `max_cost` number — Control price by setting the amount you are willing to pay in total for all results from this pipeline. Use this OR budget
  - `cloud_cover_percentage` number — Minimum cloud free area your result must have
  - `min_aoi_coverage_percentage` number — Minimum coverage of your area your result must have
  - `resolution_low` number
  - `resolution_high` number
  - `interval` string
  - `result_delivery` union — Configuration that determines which search result to process and deliver.
    - object — Evaluate all available results in the interval according to the priorities.
      - `max_latency` string — Period to collect available results before evaluation.
      - `priorities` string[]
    - object — Evaluate all available results in the interval according to the priorities.
      - `max_latency` string — Period to collect available results before evaluation.
      - `priorities` string[]
    - 'first_available' — Process and deliver the first available search result in the interval.
  - `aoi` union
    - SupportedGeojsonGeometry2 — GeoJSON Geometry supported by EarthCache™
      - `type` 'Polygon', required — The type of GeoJSON object.
      - `coordinates` array[], required
        - array[]
          - unknown[]
            - unknown
    - object
      - `ref` object, required
        - `uri` string, uri, required
  - `output` object
    - `id` string, required
    - `format` 'geotiff'
    - `mosaic` union
      - 'stitched' | 'unstitched' | 'off'
      - object
        - `type` 'stitched' | 'unstitched', required — Type of mosaic to produce.
        - `range` string — The range, in days, within the interval that results are constrained to in the mosaic. Only "1d" or the interval length are supported. If not specified, default value is interval length
  - `tags` object[]
    - `label` string, required
    - `value` string, required
  - `status` 'active' | 'inactive'
  - `sources` union
    - object
      - `include` string[], required
    - object
      - `exclude` string[], required
  - `search_id` string, uuid — Id of the search that generated the search_results
  - `search_results` union
    - string[] — List of search results from search_id to generate pipeline from
    - string, uuid — Search result from search_id to generate pipeline from
  - `off_nadir_angle` number[] — Array containing two numerical values representing the minimum and maximum off-nadir angles, in degrees, within [-90, 90].

## Response `201`

Success - pipeline(s) created

- 2xxResponse
  - `data` PipelineResource, required
    - `id` string, required
    - `name` string
    - `start_date` string, date, required
    - `end_date` string, date, required
    - `budget_per_km2` number
    - `max_cost` number
    - `resolution_low` number, required
    - `resolution_high` number, required
    - `cloud_cover_percentage` number, required
    - `min_aoi_coverage_percentage` number
    - `interval` string, required
    - `result_delivery` union, required
      - 'first_available' — Process and deliver the first available search result in the interval.
      - object — Evaluate all available results in the interval according to the priorities.
        - `max_latency` string — Period to collect available results before evaluation.
        - `priorities` string[]
      - object — Evaluate all available results in the interval according to the priorities.
        - `max_latency` string — Period to collect available results before evaluation.
        - `priorities` string[]
    - `aoi` SupportedGeojsonGeometry2 — GeoJSON Geometry supported by EarthCache™
      - `type` 'Polygon', required — The type of GeoJSON object.
      - `coordinates` array[], required
        - array[]
          - unknown[]
            - unknown
    - `area_km2` number
    - `output` object, required
      - `id` string, required
      - `format` 'geotiff', required
      - `mosaic` union, required
        - 'stitched' | 'off'
        - object
          - `type` 'stitched', required — Type of mosaic to produce. Only stitched is supported
          - `range` string — The range, in days, within the interval that results are constrained to in the mosaic. Only "1d" or the interval length are supported. If not specified, default value is interval length
    - `tags` object[]
      - `label` string, required
      - `value` string, required
    - `status` 'active' | 'inactive' | 'complete' | 'failed' | 'deactivating' | 'pending', required
    - `status_reason` object
      - `reason` 'results' | 'no_results' | 'some_results' | 'failed', required
      - `description` string
    - `search_id` string — Id of the search that generated the search_results
    - `search_results` union
      - string[] — List of search results from search_id to generate pipeline from
      - string, uuid — Search result from search_id to generate pipeline from
    - `sources` union
      - object
        - `include` string[], required
      - object
        - `exclude` string[], required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `off_nadir_angle` number[]
  - `links` object[]
    - `uri` string, uri-reference, required
  - `errors` object[] — Errors list in case of partial success
    - `message` string, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `408` — Authorization Check Timeout
- `413` — Payload too large
- `415` — Unsupported media type
- `504` — Timeout

---

[API](https://skmtc.net/skywatch/apis/api-specification.md) · [All operations](https://skmtc.net/skywatch/apis/api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skywatch/api-specification/revisions/51f7c5a8d15d/schema)