---
title: "Config Run"
method: POST
path: "/graph_interaction"
tags: ["graphs"]
---

# Config Run

`POST /graph_interaction`

## 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/graph_interaction`
- Auth: one of:
  - OpenID Connect (`https://auth.okns.de/realms/overfit-products/.well-known/openid-configuration`)
  - API key in header `X-API-Key`

Run a graph configuration. This is used when the a interaction results in a decision or written input.
Pass the according schema to the endpoint and continue the graph_run.
Pass by the graph_id, the graph_config_id the node_id and the node_config_id (read from answer of the previous interaction)

## Request body

- union
  - GraphConfigDecision
    - `type` 'Decision'
    - `graph_id` string, required
    - `graph_config_id` string, required
    - `node_id` string, required
    - `node_config_id` string, required
    - `decision` string, required
  - GraphConfigWrittenInput
    - `type` 'WrittenInput'
    - `graph_id` string, required
    - `graph_config_id` string, required
    - `node_id` string, required
    - `node_config_id` string, required
    - `input_string` string, required

## Response `200`

Successful Response

- union
  - GraphConfigFinished
    - `type` 'GraphFinished'
    - `graph_id` string, required
    - `graph_config_id` string, required
    - `node_id` string, required
    - `node_config_id` string, required
    - `chat_history` MetisMessageEntry[], required
      - `role` 'system' | 'user' | 'assistant' | 'function'
      - `content` string, nullable
      - `is_considered` boolean
      - `is_user_visible` boolean
      - `is_interaction` boolean
    - `output_string` string, required
  - GraphConfigDecisionRequired
    - `type` 'GraphDecisionRequired'
    - `graph_id` string, required
    - `graph_config_id` string, required
    - `node_id` string, required
    - `node_config_id` string, required
    - `chat_history` MetisMessageEntry[], required
      - `role` 'system' | 'user' | 'assistant' | 'function'
      - `content` string, nullable
      - `is_considered` boolean
      - `is_user_visible` boolean
      - `is_interaction` boolean
    - `question` string, nullable, required
    - `possibilities` string[], required
  - GraphConfigWrittenInputRequired
    - `type` 'GraphWrittenInputRequired'
    - `graph_id` string, required
    - `graph_config_id` string, required
    - `node_id` string, required
    - `node_config_id` string, required
    - `chat_history` MetisMessageEntry[], required
      - `role` 'system' | 'user' | 'assistant' | 'function'
      - `content` string, nullable
      - `is_considered` boolean
      - `is_user_visible` boolean
      - `is_interaction` boolean
    - `question` string, nullable, required
  - GraphConfigTokenRequried
    - `type` 'GraphTokenPermissionRequired'
    - `graph_id` string, required
    - `graph_config_id` string, required
    - `node_id` string, required
    - `node_config_id` string, required
    - `chat_history` MetisMessageEntry[], required
      - `role` 'system' | 'user' | 'assistant' | 'function'
      - `content` string, nullable
      - `is_considered` boolean
      - `is_user_visible` boolean
      - `is_interaction` boolean
    - `message` string, nullable, required
    - `url` string, required

## 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)