---
title: "Ingest a detection gpkg/geojson as a DERIVED_VECTOR item + classified features."
method: POST
path: "/v1/detections/ingest"
tags: ["resource-facade"]
---

# Ingest a detection gpkg/geojson as a DERIVED_VECTOR item + classified features.

`POST /v1/detections/ingest`

## Headers

- `x-api-key` string, nullable

## Request body

- DetectionsIngestInput
  - `project_id` string, required
  - `source_href` string, required — gs:// (or https) path to the detections gpkg/geojson
  - `name` string, required
  - `stac_id` string, nullable
  - `layer` string, nullable
  - `order_id` string, nullable
  - `source_item_id` string, nullable
  - `detected_at` string, nullable
  - `source_scene` string, nullable
  - `collection_id` string, nullable
  - `confidence_min` number, nullable
  - `capture_status` string

## Response `200`

Successful Response

- DetectionsIngestOutput
  - `item_id` string, required
  - `feature_count` integer, required
  - `by_type` object, required
  - `by_size` object, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/geopera/apis/geopera-data-platform.md) · [All operations](https://skmtc.dev/geopera/apis/geopera-data-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geopera/geopera-data-platform/revisions/cb0130b2a40a/schema)