---
title: "POST /{request_type}"
method: POST
path: "/{request_type}"
---

# POST /{request_type}

`POST /{request_type}`

## Request

- Base URL: `https://api.digifarm.io/delineation-request/v1.1`
- URL: `https://api.digifarm.io/delineation-request/v1.1/{request_type}`
- Auth: none declared. Required headers: `X-Client-Token`

Create a request for a specific service.

## Path parameters

- `request_type` 'field-delineation' | 'feature-extraction' | 'field-analysis', required

## Headers

- `X-Client-Token` string, required

## Request body

- union
  - FieldDelineationRequest
    - `bbox` object, required
      - `min_long` number, float, required
      - `min_lat` number, float, required
      - `max_long` number, float, required
      - `max_lat` number, float, required
    - `reference_year` number, required
    - `intersecting_boundaries` boolean
    - `reference_date` string: Reference date format must be any of those formats YYYY/MM/DD, DD/MM/YYYY, DD-MM-YYYY, YYYY-MM-DD
    - `message` string: Custom message providing additional information about the request.
    - `callback_url` string, uri: The URL to receive notifications about the request status.
    - `reference_image` '' | 'deep-resolution' | 'sentinel-2', required
  - FeatureExtractionRequest
    - `bbox` object, required
      - `min_long` number, float, required
      - `min_lat` number, float, required
      - `max_long` number, float, required
      - `max_lat` number, float, required
    - `reference_dates` string[], required: Reference date format must be any of those formats YYYY/MM/DD, DD/MM/YYYY, DD-MM-YYYY, YYYY-MM-DD
    - `feature_collection` number[], required: Feature collection identifier. Valid values: 1 (Built-up areas), 2 (Crop lands), 3 (Managed pastures), 4 (Natural grasslands), 5 (Natural forests), 6 (Managed forests), 7 (Solitary trees), 8 (Lakes), 9 (Ponds), 10 (Rivers/Streams), 11 (Wastelands), 12 (Wetlands), 13 (Shrublands), 14 (Perennial flower strips), 16 (Riparian buffer strips), 17 (Roads), 18 (Airstrips), 19 (Stone walls), 20 (Hedgerows)
    - `message` string: Custom message providing additional information about the request.
    - `callback_url` string, uri: The URL to receive notifications about the request status.
    - `reference_image` '' | 'deep-resolution' | 'sentinel-2', required
  - FieldAnalysisRequest
    - `field` object, required: GeoJSON object representing the field.
    - `field_id` string, required: ID of the field.
    - `analysis` 'emergence', required: Analysis to perform.
    - `sowing_date` string, date-time: Sowing date format must be any of those formats YYYY/MM/DD, DD/MM/YYYY, DD-MM-YYYY, YYYY-MM-DD
    - `crop` string: Crop to analyze.
    - `message` string: Custom message providing additional information about the request.
    - `callback_url` string, uri: The URL to receive notifications about the request status.

## Response `200`

Successfully created manual delineation request.

- CreateRequestResponse
  - `id` string
  - `status` 'QUEUED': Initial status of the request when created
  - `timestamp` string, date-time
  - `version` string

## Other responses

- `400`: Bad request. Invalid input data.
- `401`: Unauthorized. Invalid client token.
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/digifarm/apis/async-request-api-v1-1.md) - [All operations](https://skmtc.dev/digifarm/apis/async-request-api-v1-1/llms.txt) - [OpenAPI document](https://skmtc.dev/digifarm/apis/async-request-api-v1-1/revisions/b4b0b3470233?raw)