---
title: "Create Alert Type Config"
method: POST
path: "/api/v1/verification/config"
tags: ["alert-verification-config"]
---

# Create Alert Type Config

`POST /api/v1/verification/config`

Create a new alert type configuration

## Request body

- AlertConfigRequest — Create a new alert type configuration.
  - `alert_type` string, required — Alert type identifier
  - `prompt` string, required — User prompt text
  - `system_prompt` string, nullable — System prompt text
  - `enrichment_prompt` string, nullable — Optional enrichment prompt for post-verification VLM call
  - `vlm_params` VlmParams — Optional per-alert-type VLM parameter overrides. All fields are optional — only specified fields override the global ``vlm`` config in config.yaml. Unspecified fields fall back to global defaults. Unknown fields (e.g. typos) raise ValidationError at startup so config mistakes fail fast instead of being silently ignored.
    - `base_url` string, nullable
    - `model` string, nullable
    - `max_tokens` integer, nullable
    - `temperature` number, nullable
    - `request_timeout` integer, nullable
    - `use_vlm_media_defaults` boolean, nullable
    - `do_resize` boolean, nullable
    - `min_pixels` integer, nullable
    - `max_pixels` integer, nullable
    - `num_frames` integer, nullable
    - `enable_sampling` boolean, nullable
    - `sampling_fps` integer, nullable
    - `cr1_optimization` boolean, nullable
    - `max_retries` integer, nullable
    - `chunk_duration` integer, nullable
    - `num_frames_per_second_or_fixed_frames_chunk` integer, nullable
    - `enable_reasoning` boolean, nullable
  - `output_category` string, nullable — Display name for output

## Response `201`

Config created

- AlertConfigResponse — Response for a single alert type configuration.
  - `alert_type` string, required — Alert type identifier
  - `prompt` string, required — User prompt text
  - `system_prompt` string, nullable — System prompt text
  - `enrichment_prompt` string, nullable — Optional enrichment prompt
  - `vlm_params` object, nullable — VLM parameter overrides
  - `output_category` string, nullable — Display name for output
  - `created_at` string — Creation timestamp (ISO 8601)
  - `updated_at` string — Last update timestamp (ISO 8601)

## Other responses

- `409` — Config already exists
- `422` — Validation Error
- `500` — Internal server error
- `503` — Backend storage temporarily unavailable

---

[API](https://skmtc.net/nvidia/apis/alert-agent-api.md) · [All operations](https://skmtc.net/nvidia/apis/alert-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nvidia/alert-agent-api/versions/e754ab3efedd/schema)
