---
title: "Create Aithra"
method: POST
path: "/aithra"
tags: ["aithra"]
---

# Create Aithra

`POST /aithra`

## 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/aithra`
- 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 AithraGraph.
  - aithra_linkedin_interactive : LinkedIn post pipeline
  - aithra_letter_generator     : full letter pipeline (research + synergy + letter)
  - aithra_letter_generator_proof_check : proof-check variant
  - aithra_dataset_facts        : facts-only research pipeline (research/scrape/contacts, no synergy/letter)
Start with POST /aithra/{id}. For auto mode pass ?url=...&prompt=... on the start request.

## Request body

- union
  - AithraLinkedInInteractiveCreate
    - `type` 'aithra_linkedin_interactive'
    - `linkedin_urn` string, nullable
    - `client` 'consumer' | 'business'
    - `system_prompt` string, nullable
    - `user_prompt` string, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `language` string, nullable
  - AithraLetterGeneratorCreate
    - `type` 'aithra_letter_generator'
    - `name` string, nullable
    - `description` string, nullable
    - `llm_provider` string, nullable
  - AithraLetterGeneratorProofCheckCreate
    - `type` 'aithra_letter_generator_proof_check'
    - `name` string, nullable
    - `description` string, nullable
  - AithraDatasetFactsCreate: Facts-only Aithra: research/scrape/contact extraction without synergy analysis, letter generation, QA grading, or letter-DB persistence. Consumed by the `dataset` entity to fill Tier A company facts; the lens layer (scoring/synergy/perspective) is owned downstream, not here. Default llm_provider is mistral.
    - `type` 'aithra_dataset_facts'
    - `name` string, nullable
    - `description` string, nullable
    - `llm_provider` string, nullable

## Response `200`

Successful Response

- AithraGraph
  - `id` string, required
  - `graph_id` string, required
  - `type` 'aithra_linkedin_interactive' | 'aithra_linkedin_url' | 'aithra_linkedin_auto' | 'aithra_twitter' | 'aithra_email' | 'aithra_letter_generator' | 'aithra_letter_generator_proof_check' | 'aithra_dataset_facts', required
  - `sub` string, required
  - `create_json` union, required
    - AithraLinkedInInteractiveCreate
      - `type` 'aithra_linkedin_interactive'
      - `linkedin_urn` string, nullable
      - `client` 'consumer' | 'business'
      - `system_prompt` string, nullable
      - `user_prompt` string, nullable
      - `name` string, nullable
      - `description` string, nullable
      - `language` string, nullable
    - AithraEmailCreate
      - `type` 'aithra_email', required
      - `email` string, required
      - `system_prompt` string, nullable
      - `user_prompt` string, nullable
      - `name` string, nullable
      - `description` string, nullable
    - AithraLetterGeneratorCreate
      - `type` 'aithra_letter_generator'
      - `name` string, nullable
      - `description` string, nullable
      - `llm_provider` string, nullable
    - AithraLetterGeneratorProofCheckCreate
      - `type` 'aithra_letter_generator_proof_check'
      - `name` string, nullable
      - `description` string, nullable
    - AithraDatasetFactsCreate: Facts-only Aithra: research/scrape/contact extraction without synergy analysis, letter generation, QA grading, or letter-DB persistence. Consumed by the `dataset` entity to fill Tier A company facts; the lens layer (scoring/synergy/perspective) is owned downstream, not here. Default llm_provider is mistral.
      - `type` 'aithra_dataset_facts'
      - `name` string, nullable
      - `description` string, nullable
      - `llm_provider` string, nullable
  - `time_created` string, date-time, 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)