---
title: "PUT /farm-operations/ingest-data/{jobId}"
method: PUT
path: "/farm-operations/ingest-data/{jobId}"
tags: ["FarmOperations"]
---

# PUT /farm-operations/ingest-data/{jobId}

`PUT /farm-operations/ingest-data/{jobId}`

Create a farm operation data ingestion job.

## Path parameters

- `jobId` string, required

## Query parameters

- `api-version` string, required

## Request body

- FarmOperationDataIngestionJob — Schema of farm operation data ingestion job.
  - `partyId` string, required — Party Id.
  - `authProviderId` string, required — Authentication provider Id.
  - `operations` string[] — List of operation types for which data needs to be downloaded. Available values: AllOperations, Application, Planting, Harvest, Tillage.
  - `startYear` integer, required — Start Year (Minimum = 2000, Maximum = CurrentYear).
  - `isIncremental` boolean — Use this to pull only the incremental changes from the last run.
  - `providerInput` FarmOperationJobProviderInput, required — Schema for provider input for Farm operations job.
    - `shapeType` 'Point' | 'Polygon' | 'None', required — Type of shape file to be ingested from JohnDeere. Possible values of shape file type are taken from - https://developer-portal.deere.com/#/myjohndeere/field-operations/field-operations?hash=download-shapefile.
    - `shapeResolution` 'EachSection' | 'EachSensor' | 'OneHertz' | 'None', required — Resolution of shape file to be ingested from JohnDeere. Possible values of shape file resolution are taken from - https://developer-portal.deere.com/#/myjohndeere/field-operations/field-operations?hash=download-shapefile.
  - `id` string — Unique job id.
  - `status` string — Status of the job. Possible values: 'Waiting', 'Running', 'Succeeded', 'Failed', 'Cancelled'.
  - `durationInSeconds` number, double — Duration of the job in seconds.
  - `message` string — Status message to capture more details of the job.
  - `errorCode` string — Error Code when job failed.
  - `createdDateTime` string, date-time — Job created at dateTime. Sample format: yyyy-MM-ddTHH:mm:ssZ.
  - `lastActionDateTime` string, date-time — Job was last acted upon at dateTime. Sample format: yyyy-MM-ddTHH:mm:ssZ.
  - `startTime` string, date-time — Job start time when available. Sample format: yyyy-MM-ddTHH:mm:ssZ.
  - `endTime` string, date-time — Job end time when available. Sample format: yyyy-MM-ddTHH:mm:ssZ.
  - `name` string — Name to identify resource.
  - `description` string — Textual description of the resource.
  - `createdBy` string — Created by user/tenant id.
  - `modifiedBy` string — Modified by user/tenant id.
  - `properties` object — A collection of key value pairs that belongs to the resource. Each pair must not have a key greater than 50 characters and must not have a value greater than 150 characters. Note: A maximum of 25 key value pairs can be provided for a resource and only string, numeral and datetime (yyyy-MM-ddTHH:mm:ssZ) values are supported.

## Response `202`

Accepted

- FarmOperationDataIngestionJob — Schema of farm operation data ingestion job.
  - `partyId` string, required — Party Id.
  - `authProviderId` string, required — Authentication provider Id.
  - `operations` string[] — List of operation types for which data needs to be downloaded. Available values: AllOperations, Application, Planting, Harvest, Tillage.
  - `startYear` integer, required — Start Year (Minimum = 2000, Maximum = CurrentYear).
  - `isIncremental` boolean — Use this to pull only the incremental changes from the last run.
  - `providerInput` FarmOperationJobProviderInput, required — Schema for provider input for Farm operations job.
    - `shapeType` 'Point' | 'Polygon' | 'None', required — Type of shape file to be ingested from JohnDeere. Possible values of shape file type are taken from - https://developer-portal.deere.com/#/myjohndeere/field-operations/field-operations?hash=download-shapefile.
    - `shapeResolution` 'EachSection' | 'EachSensor' | 'OneHertz' | 'None', required — Resolution of shape file to be ingested from JohnDeere. Possible values of shape file resolution are taken from - https://developer-portal.deere.com/#/myjohndeere/field-operations/field-operations?hash=download-shapefile.
  - `id` string — Unique job id.
  - `status` string — Status of the job. Possible values: 'Waiting', 'Running', 'Succeeded', 'Failed', 'Cancelled'.
  - `durationInSeconds` number, double — Duration of the job in seconds.
  - `message` string — Status message to capture more details of the job.
  - `errorCode` string — Error Code when job failed.
  - `createdDateTime` string, date-time — Job created at dateTime. Sample format: yyyy-MM-ddTHH:mm:ssZ.
  - `lastActionDateTime` string, date-time — Job was last acted upon at dateTime. Sample format: yyyy-MM-ddTHH:mm:ssZ.
  - `startTime` string, date-time — Job start time when available. Sample format: yyyy-MM-ddTHH:mm:ssZ.
  - `endTime` string, date-time — Job end time when available. Sample format: yyyy-MM-ddTHH:mm:ssZ.
  - `name` string — Name to identify resource.
  - `description` string — Textual description of the resource.
  - `createdBy` string — Created by user/tenant id.
  - `modifiedBy` string — Modified by user/tenant id.
  - `properties` object — A collection of key value pairs that belongs to the resource. Each pair must not have a key greater than 50 characters and must not have a value greater than 150 characters. Note: A maximum of 25 key value pairs can be provided for a resource and only string, numeral and datetime (yyyy-MM-ddTHH:mm:ssZ) values are supported.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/azure/apis/agrifood-agfoodplatform.md) · [All operations](https://skmtc.net/azure/apis/agrifood-agfoodplatform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/agrifood-agfoodplatform/revisions/33cf1de6e0c4/schema)