entity detach

Entfernt einen einzelnen Eintrag aus representations oder external einer Entität. Das Gegenstück zu entity attach und entity external — für den Fall, dass du eine Repräsentation oder einen externen Verweis wieder loswerden willst, ohne die Binärdatei selbst zu löschen.

Eine Repräsentation entfernen

Die Asset-NanoID ist der Schlüssel — sie steht im Dateinamen des Assets zwischen dem letzten -- und der Endung. Beispiel: Asset­datei ../assets/2026-04-21--interview-max--Fg6hJk4l.mp3 hat die NanoID Fg6hJk4l.

apparat entity detach V1StGXRa Fg6hJk4l

Apparat entfernt den passenden Eintrag aus representations. Die Asset­datei selbst bleibt in assets/ stehen — das Aufräumen verwaister Binärdateien ist ein separater Arbeits­schritt (Orphan-Asset-Check, siehe Ausblick).

Einen externen Verweis entfernen

Mit einer URL als Target entfernt Apparat den passenden Eintrag aus external:

apparat entity detach V1StGXRa https://example.com/vortrag-2025

Der Vergleich ist exakt — Groß-/Kleinschreibung, Trailing-Slashes und Query-Strings werden nicht normalisiert. Wenn du den genauen Wert nicht parat hast, ruf entity meta auf und kopiere die URL aus der Anzeige.

Wann was hilft

• Repräsentation entfernen, Asset behalten → entity detach mit Asset-NanoID. Die Binärdatei bleibt unter assets/, nur die Verknüpfung zur Entität wird gelöst.
• Repräsentation und Asset endgültig löschen → entity detach + manuelles Löschen der Datei unter assets/.
• Externen Verweis ändern statt entfernen → entity meta. Die Freitext­felder url, format, title bearbeitest du dort.

Vault wählen

Ohne --vault verwendet Apparat die übliche Auflösung. Mit --vault übersteuerst du sie:

apparat entity detach V1StGXRa Fg6hJk4l --vault=arbeit

Fehler

• „Entity id "…" is not a valid NanoId" — das Entitäts-Argument muss eine 8-stellige NanoID aus [A-Za-z0-9] sein.
• „No entity with id "…" in vault "…"" — zur angegebenen Entitäts-NanoID existiert im Vault keine Datei.
• „Detach target "…" must be an asset NanoId (8 chars) or a URL with scheme" — das zweite Argument ist weder eine 8-stellige NanoID noch eine URL mit Schema.
• „No representation with asset id "…" found on this entity" — die Entität hat keinen representations-Eintrag, dessen Pfad auf die angegebene Asset-NanoID endet.
• „No external entry with url "…" found on this entity" — die Entität hat keinen external-Eintrag mit genau dieser URL.

Wirkung im Vault

entity detach entfernt nur den Verweis aus dem Frontmatter der angesprochenen Entität — die Asset-Datei in assets/ bleibt liegen, ebenso Verweise auf dasselbe Asset aus anderen Entitäten (Binärdateien dürfen aus mehreren Notizen heraus verlinkt werden). Der Markdown-Body wird nicht angefasst: ein eingebetteter Inline-Verweis auf dasselbe Asset bleibt bestehen, bis du ihn selbst änderst.