---
title: "POST /inma/collections/{collectionId}/ingestions/{ingestionId}/runs"
method: POST
path: "/inma/collections/{collectionId}/ingestions/{ingestionId}/runs"
tags: ["Ingestion Management"]
---

# POST /inma/collections/{collectionId}/ingestions/{ingestionId}/runs

`POST /inma/collections/{collectionId}/ingestions/{ingestionId}/runs`

Create a new run of an ingestion

## Path parameters

- `collectionId` string, required
- `ingestionId` string, uuid, required

## Query parameters

- `api-version` string, required

## Response `201`

The request has succeeded and a new resource has been created as a result.

- IngestionRun — Microsoft Planetary Computer Pro geo-catalog ingestion run
  - `id` string, uuid, required — Universally Unique Identifier
  - `parentRunId` string, uuid — Universally Unique Identifier
  - `operation` IngestionRunOperation, required — Microsoft Planetary Computer Pro geo-catalog ingestion run operation
    - `id` string, uuid, required — Universally Unique Identifier
    - `status` 'Pending' | 'Running' | 'Succeeded' | 'Canceled' | 'Canceling' | 'Failed', required — Operation status
    - `creationTime` string, date-time, required — The UTC time at which the operation was created
    - `statusHistory` OperationStatusHistoryItem[], required — The history of the operation status in time
      - `timestamp` string, date-time, required — The UTC time at which the status was set
      - `status` 'Pending' | 'Running' | 'Succeeded' | 'Canceled' | 'Canceling' | 'Failed', required — Operation status
      - `errorCode` string — If the status is failed, the error code
      - `errorMessage` string — If the status is failed, the error message
    - `startTime` string, date-time — The UTC time at which the operation was started
    - `finishTime` string, date-time — The UTC time at which the operation finished its execution
    - `totalItems` integer, required — The number of total items to be processed
    - `totalPendingItems` integer, required — The number of items pending to be processed
    - `totalSuccessfulItems` integer, required — The number of items successfully processed
    - `totalFailedItems` integer, required — The number of items that have failed to be processed
  - `creationTime` string, date-time, required — Creation time
  - `sourceCatalogUrl` string, uri — URL of the source catalog
  - `skipExistingItems` boolean — Skip any item that already exist in the GeoCatalog
  - `keepOriginalAssets` boolean — Keep original source assets

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer.md) · [All operations](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/orbital-microsoft-planetarycomputer/revisions/42447be18bc5/schema)