---
title: "Eine Karte anlegen"
method: POST
path: "/api/karten"
tags: ["Karten"]
---

# Eine Karte anlegen

`POST /api/karten`

## Request

- Base URL: `https://knowmind.de`
- URL: `https://knowmind.de/api/karten`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `authjs.session-token`

Legt eine Karte mit Titel und Blockbaum an. Mit einem Zugangsschlüssel angelegte Karten landen im Eingang und erscheinen erst nach der Annahme durch einen Menschen in den Arbeitsansichten; über die angemeldete Oberfläche angelegte Karten nicht. `in_den_eingang` im Rumpf entscheidet in beiden Richtungen.

## Request body

- object
  - `titel` string, required
  - `bloecke` object[]
  - `zweitnamen` string[]
  - `in_den_eingang` boolean

## Response `200`

Angelegt

- object
  - `document_id` string, uuid
  - `abschnitte` integer
  - `eingang` 'wartet': Steht nur dort, wo die Karte in den Eingang gelegt wurde.

## Other responses

- `403`: Das Token darf nur lesen (insufficient_scope)

---

[API](https://skmtc.dev/knowmind/apis/knowmind-api.md) · [All operations](https://skmtc.dev/knowmind/apis/knowmind-api/llms.txt) · [OpenAPI document](https://skmtc.dev/knowmind/apis/knowmind-api/revisions/c369431c0e59?raw)