---
title: "Nachweis anlegen (Datei hochladen, poe oder write)"
method: POST
path: "/v1/poe/file"
tags: ["Proof of Existence"]
---

# Nachweis anlegen (Datei hochladen, poe oder write)

`POST /v1/poe/file`

## Request

- Base URL: `https://doi-api.sendlabs.de` (the document declares no server; this is the origin it was published from)
- URL: `https://doi-api.sendlabs.de/v1/poe/file`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Verankert poe/<hash> per name_doi mit dem Node-Wallet. Ist der Hash schon aktiv verankert (confirmed) oder wartet eine Operation im Mempool (pending), antwortet die API mit 409. Ist die Registrierung abgelaufen (expired), ebenfalls mit 409, denn der fruehere Nachweis bleibt in der Kettenhistorie gueltig und eine neue Registrierung fuegt nur einen spaeteren Zeitstempel hinzu und ersetzt Notiz und Inhaber des Namens. Mit reanchor=true wird ein abgelaufener Hash bewusst neu registriert, die Antwort enthaelt dann reanchored_after_expiry:true und das aeltere Feld renewed mit demselben Wert. Der Nachweiszeitpunkt bleibt die erste Verankerung (first_anchored in GET /v1/poe/{hash}). reanchor ist hier ein Formularfeld (true oder false).

## Response `201`

Successful Response

- unknown

## Other responses

- `400`: Eingabe fehlerhaft oder von der Node abgelehnt
- `401`: Schluessel fehlt oder ist ungueltig
- `402`: Node-Wallet ohne Guthaben (nur schreibende Aufrufe)
- `403`: Schluesselstufe reicht nicht oder Methode gesperrt
- `404`: Name, Block, Transaktion oder Pfad nicht vorhanden
- `405`: HTTP-Methode fuer diesen Pfad nicht erlaubt
- `409`: Konflikt: schon registriert, fremder Inhaber, wartende oder abgelehnte Operation
- `413`: Anfrage zu gross (JSON 64 KB, Rohtransaktionen 1 MB, Uploads 50 MB)
- `422`: JSON-Body oder Parameter passen nicht zum Schema
- `423`: Wallet gesperrt
- `429`: Ratenbegrenzung
- `500`: Interner Fehler der API
- `502`: Unerwarteter Fehler der Node oder API-Dienst nicht erreichbar
- `503`: Node oder ElectrumX nicht erreichbar oder noch nicht synchron
- `504`: Zeitueberschreitung

---

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