---
title: "Graph Start"
method: POST
path: "/graph/{graph_id}"
tags: ["graphs"]
---

# Graph Start

`POST /graph/{graph_id}`

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

Start a graph.
This starts from the predefined starting node. This will create a new configuration so it instanciates a complete new workflow and does not remember any prior  runs.

## Path parameters

- `graph_id` 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)