---
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`

## Request

- Base URL: `{endpoint}`
- URL: `{endpoint}/inma/collections/{collectionId}/ingestions/{ingestionId}/runs`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `https://geocatalog.spatio.azure.com/.default`

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.dev/azure/apis/orbital-microsoft-planetarycomputer.md) - [All operations](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/revisions/42447be18bc5?raw)