---
title: "Create Question Share"
method: POST
path: "/insight/{insight_id}/share/questions"
tags: ["questions"]
---

# Create Question Share

`POST /insight/{insight_id}/share/questions`

## Request

- Base URL: `https://api.overfit.de` (the document declares no server; this is the origin it was published from)
- URL: `https://api.overfit.de/insight/{insight_id}/share/questions`
- Auth: one of:
  - OpenID Connect (`https://auth.okns.de/realms/overfit-products/.well-known/openid-configuration`)
  - API key in header `X-API-Key`

Create a new question. A Question is allways associated with an insight and can not be created without an insight.
Accepts Insight ID (ins_) and QuestionCreate Schema as input.
The Question is processed and answered, the Answer is in the Question Schema the result.
This endpoint is for asking questions against a shared insight. Shared insights need to be defined by the owner of the insight.

## Path parameters

- `insight_id` string, required

## Request body

- QuestionCreate
  - `question` string, required
  - `question_type` 'SUMMARY' | 'AGENT' | 'HYBRID' | 'FULL_TEXT' | 'FULL_TEXT_EXACT'

## Response `200`

Successful Response

- Question
  - `id` string, required
  - `question` string, required
  - `time_created` string, date-time, required
  - `question_steps` QuestionStep[], nullable
    - `id` string, required
    - `question_id` string, required
    - `order` integer, required
    - `step_type` string, required
    - `step_message` string, required
  - `insight_id` string, required
  - `result` string, nullable, required
  - `question_type` 'SUMMARY' | 'AGENT' | 'HYBRID' | 'FULL_TEXT' | 'FULL_TEXT_EXACT', required
  - `status` string, required
  - `sources` Source[]
    - `id` string, required
    - `name` string, nullable
    - `description` string, nullable
    - `insight_id` string, required
    - `time_created` string, date-time, required
    - `source_type` 'WEBSITE' | 'REMOTE_DOCUMENT' | 'SEARCH' | 'DOCUMENT_UPLOAD', required
    - `public` boolean
    - `keywords` string, nullable
    - `path` string, required
    - `length` integer, required
  - `sub` string, uuid, required
  - `length` integer, required
  - `source_snippets` SourceSnippet[], nullable
    - `source_id` string, required
    - `snippet_id` string, required
    - `snippet` string, required
    - `score` number

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/overfit/apis/overfit-insights-revolutionizing-data-retrieval.md) · [All operations](https://skmtc.dev/overfit/apis/overfit-insights-revolutionizing-data-retrieval/llms.txt) · [OpenAPI document](https://skmtc.dev/overfit/apis/overfit-insights-revolutionizing-data-retrieval/revisions/0055f7fe41e5?raw)