---
title: "Create Insights on an AOI"
method: POST
path: "/v0/aoi/{aoi_id}/insights"
tags: ["Insights"]
---

# Create Insights on an AOI

`POST /v0/aoi/{aoi_id}/insights`

Creates an insight or get the estimated cost of running the insight.

## Path parameters

- `aoi_id` string, required

## Request body

- DexterCreateInsightsWildcardTransformerRequest
  - `name` string — Name is a human-readable title for the insight
  - `block` object, required — Describes the processing block to use for the insight
    - `name` string — Name of the block
    - `string` string — Id is a unique identifier for the block
    - `version` string, required — Semantic version of the block to use
  - `input` integer[], required — Inputs to the insight
  - `project_id` string — Identifies which project this insight belongs to
  - `metadata` object — Contains additional key-value information about the insight
  - `estimate` boolean — Indicates whether to return a cost estimate instead of running the insight.

## Response `200`

When estimating cost

- DexterCreateInsightCostEstimateUpstreamResponseBody
  - `estimate` integer — Estimate provides the computed cost value for the insight execution

## Other responses

- `201` — When creating an insight
- `400` — Bad Request
- `403` — Forbidden

---

[API](https://skmtc.net/pixxel/apis/stargate.md) · [All operations](https://skmtc.net/pixxel/apis/stargate/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pixxel/stargate/revisions/b501e2ca5a9d/schema)