---
title: "Update Order"
method: PATCH
path: "/pipelines/{id}"
tags: ["legacyPipelines"]
---

# Update Order

`PATCH /pipelines/{id}`

Update an existing order configuration. You can modify certain parameters like the end date or processing options if the order has not yet started processing. Most parameters cannot be changed once processing begins.

## Request body

- union
  - PipelineUpdate
    - `name` string
    - `aoi` SupportedGeojsonGeometry2 — GeoJSON Geometry supported by EarthCache™
      - `type` 'Polygon', required — The type of GeoJSON object.
      - `coordinates` array[], required
        - array[]
          - unknown[]
            - unknown
    - `tags` object[]
      - `label` string, required
      - `value` string, required
    - `status` 'active' | 'inactive'
  - union — This object represents a geometry, feature, or collection of features.
    - object
      - `type` 'FeatureCollection', required
      - `features` SupportedGeojsonFeature[], required
        - `type` 'Feature'
        - `geometry` SupportedGeojsonGeometry2, required — GeoJSON Geometry supported by EarthCache™
          - `type` 'Polygon', required — The type of GeoJSON object.
          - `coordinates` array[], required
            - array[]
              - …
    - object
      - `type` 'Feature', required
      - `geometry` SupportedGeojsonGeometry2, required — GeoJSON Geometry supported by EarthCache™
        - `type` 'Polygon', required — The type of GeoJSON object.
        - `coordinates` array[], required
          - array[]
            - unknown[]
              - …
    - object — GeoJSON Geometry supported by EarthCache™
      - `type` 'Polygon', required — The type of GeoJSON object.
      - `coordinates` array[], required
        - array[]
          - unknown[]
            - unknown

## Response `200`

Success - pipeline updated

- 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

- `201` — Success - pipeline updated and pipeline(s) created
- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `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)