---
title: "Namen per name_doi registrieren, aktualisieren oder verlaengern (write)"
method: POST
path: "/v1/name/doi"
tags: ["Namen"]
---

# Namen per name_doi registrieren, aktualisieren oder verlaengern (write)

`POST /v1/name/doi`

## 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/name/doi`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Ein freier oder abgelaufener Name wird registriert, ein eigener aktiver Name aktualisiert (das verlaengert den Ablauf um 36.000 Bloecke). Je Name ist nur eine unbestaetigte Operation erlaubt.

## Request body

- NameDoi
  - `name` string, required: Name, zum Beispiel poe/<hash> oder id/meinname (bis 255 Byte)
  - `value` string: Wert (Text bis 520 Byte oder Hex, siehe value_encoding)
  - `dest_address` string, nullable: Adresse, die den Namen halten soll (Standard: neue Adresse des Node-Wallets)
  - `name_encoding` string, nullable: ascii, utf8 (Standard) oder hex, leer = Standard
  - `value_encoding` string, nullable: ascii, utf8 (Standard) oder hex, leer = Standard

## Response `200`

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)