---
title: "Create Detection"
method: POST
path: "/v1/detections"
tags: ["Dome", "detections"]
---

# Create Detection

`POST /v1/detections`

Create a new detection request.

This endpoint accepts a detection request and starts processing it
asynchronously. The response includes the detection ID which can be
used to poll for results via GET /detections/{id}.

Note: This endpoint does not require authentication to support
the Execution Flow test input feature.

## Request body

- DetectionRequest — Request model for creating a detection.
  - `id` string, required
  - `detector_id` string, required
  - `detector_params` DetectionParams — Parameters for a detection request.
    - `api_key_proxy` string, nullable
    - `hub` string, nullable
    - `model` string, nullable
  - `detector_inputs` DetectionInput[], required
    - `response` string, nullable
    - `question` string, nullable
    - `prompt` string, nullable
    - `dome_detection_method` string, nullable

## Response `201`

Successful Response

- DetectionResponse — Response model for a detection.
  - `id` string, required
  - `status` string, required
  - `detector_inputs` DetectionInput[]
    - `response` string, nullable
    - `question` string, nullable
    - `prompt` string, nullable
    - `dome_detection_method` string, nullable
  - `detector_outputs` DetectionOutput[]
    - `score` number
    - `label` string, nullable
    - `details` object, nullable
  - `error_message` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/vijilai/apis/vijil-console-api-combined.md) · [All operations](https://skmtc.net/vijilai/apis/vijil-console-api-combined/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vijilai/vijil-console-api-combined/versions/a8b2ee2b2d06/schema)
