Skip to main content
PATCH
Kunden ändern

Authorizations

Authorization
string
header
required

Access-Token aus POST /auth/login (E-Mail und Passwort), gesendet als Authorization: Bearer <token>.

Das Token ist zeitlich begrenzt gültig. Mit dem refresh_token aus derselben Antwort holt POST /auth/token/refresh ein neues Token-Paar, ohne das Passwort erneut zu senden; POST /auth/token/invalidate macht den Refresh-Token beim Abmelden ungültig.

Ist für das Konto ein zweiter Faktor aktiv oder vorgeschrieben, liefert der Login statt des Token-Paars mfaRequired: true bzw. mfaEnrollmentRequired: true und ein kurzlebiges preAuthToken. Mit diesem Token (ebenfalls als Bearer) wird der zweite Faktor über POST /auth/2fa/verify bestätigt; erst danach gibt es das volle Token-Paar.

Headers

X-Customer-Id
string

Optionaler Kundenkontext. Ohne Header arbeitet die Anfrage im Standard-Kunden des angemeldeten Benutzers. Mit der ID eines anderen Kunden handelt die Anfrage in dessen Kontext: Listen, Lese- und Schreibzugriffe beziehen sich dann auf diesen Kunden.

Erlaubt sind der eigene Kunde, jeder Unterkunde im eigenen Teilbaum (Reseller handelt für seinen Endkunden) sowie Kunden, in denen der Benutzer selbst Mitglied ist. Übergeordnete oder fremde Kunden werden mit 403 Forbidden abgewiesen, eine unbekannte ID ebenfalls.

Die IDs der erreichbaren Kunden liefern GET /user/customers und GET /customers/{id}/children.

Example:

"01JD4Q8W3N6Y2K5T7R9V0B1C2D"

Path Parameters

id
string
required

Customer identifier

Body

application/merge-patch+json

The updated Customer resource

name
string

The name of the customer

Required string length: 2 - 255
Example:

"ACME Inc."

mfaPolicy
enum<string> | null

MFA obligation for this customer and its subtree (OPTIONAL|REQUIRED_FOR_ADMINS|REQUIRED)

Available options:
OPTIONAL,
REQUIRED_FOR_ADMINS,
REQUIRED,
null
Example:

"REQUIRED_FOR_ADMINS"

mfaGraceDays
integer | null

Grace period in days before the MFA obligation is enforced

Required range: 0 <= x <= 365
Example:

14

priceListTemplate
string<iri-reference> | null

Zugewiesene Domain-Preislistenvorlage (für Reseller).

Example:

"https://example.com/"

Response

Customer resource updated

name
string
required

The name of the customer

Required string length: 2 - 255
Example:

"ACME Inc."

id
string
read-only
Example:

"01F9Z3ZJXZQZJZJZJZJZJZJZJZ"

customerNumber
string
read-only
vatValidated
boolean
default:false
read-only

True once the VAT ID (vatNumber) has been positively confirmed via VIES (or the configured validation service). Only a validated EU VAT ID makes the customer eligible for reverse charge. Defaults to false — an unverified or unverifiable VAT ID is never treated as reverse-charge eligible.

vatValidatedAt
string<date-time> | null
read-only

Timestamp of the last successful VIES validation of the current VAT ID.

billingCountryCode
string | null

ISO 3166-1 alpha-2 country code of the customer's billing address.

fynnDebtorId
string | null

Fynn-Debitor des Kunden. Nur in /user/me lesbar (Gruppe ME), also für den Kunden selbst: Shop und Panel geben die Kennung an die Auswertung weiter, damit sich Besuche später der Abrechnung zuordnen lassen (ARC-211). null, solange das Onboarding den Debitor noch nicht angelegt hat oder der Kunde über den Elternkunden abgerechnet wird.

isResellingEnabled
boolean
default:false
canManageBrands
boolean
default:false

Capability: darf eigene Brands (Auftritte) anlegen und verwalten.

billingMode
enum<string> | null
Available options:
PREPAID,
POSTPAID,
null
mfaPolicy
enum<string> | null

MFA obligation for this customer and its subtree (OPTIONAL|REQUIRED_FOR_ADMINS|REQUIRED)

Available options:
OPTIONAL,
REQUIRED_FOR_ADMINS,
REQUIRED,
null
Example:

"REQUIRED_FOR_ADMINS"

mfaGraceDays
integer | null

Grace period in days before the MFA obligation is enforced

Required range: 0 <= x <= 365
Example:

14

priceListTemplate
string<iri-reference> | null

Zugewiesene Domain-Preislistenvorlage (für Reseller).

Example:

"https://example.com/"

lockedAt
string<date-time> | null
read-only

Read-only: set when platform staff locked this customer (ISO 8601)

derivedRole
string
read-only

Derived role (ROOT|RESELLER|CUSTOMER), computed from hierarchy and capabilities

Example:

"RESELLER"

warnings
object[]
read-only

Hinweise zur letzten Änderung (z. B. mfa_policy_tightened mit affectedUsers/notifiedUsers); nie persistiert