---
title: "Create insight record"
method: POST
path: "/create/insight"
tags: ["insights"]
---

# Create insight record

`POST /create/insight`

Create insight record with given parameters

## Request body

- CreateInsight
  - `insight_name` string, required — Name of the insight. Type: string.
  - `insight_type` string, required — Type of the insight (e.g., LLM, keyword). Type: string.
  - `indicator_score_type` string, required — Score type for the indicator. Type: string.
  - `insight_description` string — Description of the insight. Type: string.
  - `insight_help` string — Help text for the insight. Type: string.
  - `group_list` integer[], required — List of group IDs associated with the insight (Available for). Type: array of integer.
  - `insight_guideline` string — Guidelines for the insight (for LLM type). Type: string.
  - `insight_output` string — Output for the insight (for LLM type). Type: string.
  - `insight_example` string — Example for the insight (for LLM type). Type: string.
  - `hit_outcome_by` string — Hit outcome by (for keyword type). Type: string.
  - `miss_outcome_by` string — Miss outcome by (for keyword type). Type: string.
  - `hit_keywords` string — Hit keywords (comma-separated, for keyword type). Type: string.
  - `miss_keywords` string — Miss keywords (comma-separated, for keyword type). Type: string.
  - `hit_mention` string — Hit mention (for keyword type). Type: string.
  - `miss_mention` string — Miss mention (for keyword type). Type: string.

## Response `200`

The result of the submission and insight_id for the newly added insight.

- PostResponse
  - `result` string, required — Outcome of the request. String, typically 'success' or 'error'.
  - `err` string, required — Error message when result='error'. String. Empty/null on success.
  - `data` string — Response payload. Shape varies by endpoint.

## Other responses

- `default` — Unexpected error

---

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