> ## Documentation Index
> Fetch the complete documentation index at: https://docs.netzfabrik.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Master-Adressen einer Slave-Zone ändern

> Setzt die Master-Adressen neu und stößt einen Transfer an. Erlaubt sind nur öffentliche IPv4- und IPv6-Adressen ohne Port.

Wenn TSIG angeboten wird (`tsigAvailable` in den Einstellungen), kannst du mit `tsigKey` einen Schlüssel hinterlegen oder ihn mit `removeTsigKey: true` entfernen.



## OpenAPI

````yaml /api-reference/openapi.json put /dns/zones/{id}/secondary
openapi: 3.1.0
info:
  title: NETZFABRIK API
  description: >-
    REST-API der NETZFABRIK-Plattform für Domains, DNS, Cloud-Server, Webspaces,
    E-Mail-Dienste und Konto. Authentifizierung per JWT (Authorization: Bearer)
    oder API-Token (X-API-TOKEN).
  termsOfService: https://www.netzfabrik.com/tos
  contact:
    name: NETZFABRIK GmbH
    url: https://www.netzfabrik.com
    email: info@netzfabrik.com
  license:
    name: Proprietary
    url: https://www.netzfabrik.com/license
  version: 2026-11-21-4c0ba7f0
servers:
  - url: https://api.netzfabrik.com
security:
  - JWT: []
  - ApiToken: []
tags:
  - name: Login
  - name: Zwei-Faktor-Authentifizierung
  - name: Passkeys
  - name: Benutzer
  - name: Konten
  - name: Kunden
  - name: Verträge
  - name: Rechnungen
  - name: Support-Tickets
  - name: Domains
  - name: Domain-Labels
  - name: Domain-Bestellungen
  - name: Premium-Domains
  - name: Inhaberwechsel
  - name: Handles (Kontakte)
  - name: Handle-Verifizierung
  - name: TLD-Daten
  - name: Domain-Preise
  - name: Preislisten-Vorlagen
  - name: Preislisten-Versionen
  - name: Preis-Überschreibungen
  - name: Preisänderungen
  - name: Domain-Aktionen
  - name: Öffentliche Preislisten
  - name: Domain-Reseller
  - name: DNS-Zonen
  - name: DNS-Records
  - name: Weiterleitungen
  - name: Webhooks
  - name: Cloud-Server
  - name: Cloud-Server-Vorlagen
  - name: Regionen
  - name: SSH-Keys
  - name: ISO-Images
  - name: Anwendungen
  - name: Webspaces
  - name: Webspace-Tarife
  - name: Object Storage
  - name: E-Mail-Protection
  - name: E-Mail-Security
  - name: E-Mail-Archiv
  - name: Colocation
  - name: Racks
  - name: Stromzuführungen
  - name: Interconnections
  - name: VLANs
  - name: Traffic
  - name: DnsZoneTemplate
  - name: DnsZoneTemplateRun
  - name: DnsZoneTemplateSettings
paths:
  /dns/zones/{id}/secondary:
    put:
      tags:
        - DNS-Zonen
      summary: Master-Adressen einer Slave-Zone ändern
      description: >-
        Setzt die Master-Adressen neu und stößt einen Transfer an. Erlaubt sind
        nur öffentliche IPv4- und IPv6-Adressen ohne Port.


        Wenn TSIG angeboten wird (`tsigAvailable` in den Einstellungen), kannst
        du mit `tsigKey` einen Schlüssel hinterlegen oder ihn mit
        `removeTsigKey: true` entfernen.
      operationId: updateDnsSecondaryZone
      parameters:
        - name: id
          in: path
          description: Zone identifier
          required: true
          deprecated: false
          schema:
            type: string
          style: simple
          explode: false
        - $ref: '#/components/parameters/CustomerId'
      requestBody:
        description: The updated Zone resource
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/Zone.SecondaryZoneUpdateInput-zone.secondary-write
        required: true
      responses:
        '200':
          description: Zone resource updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Zone.SecondaryZoneView-zone.secondary'
          links: {}
        '400':
          description: Invalid input
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error'
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          links: {}
        '403':
          description: Forbidden
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error'
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          links: {}
        '404':
          description: Not found
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error'
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          links: {}
        '422':
          description: An error occurred
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ConstraintViolation'
            application/json:
              schema:
                $ref: '#/components/schemas/ConstraintViolation'
          links: {}
components:
  parameters:
    CustomerId:
      name: X-Customer-Id
      in: header
      required: false
      description: >-
        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`.
      schema:
        type: string
        example: 01JD4Q8W3N6Y2K5T7R9V0B1C2D
  schemas:
    Zone.SecondaryZoneUpdateInput-zone.secondary-write:
      type: object
      properties:
        masterIpAddresses:
          description: Neue Master-Adressen (1 bis 5, öffentliche IPv4/IPv6 ohne Port).
          example:
            - 198.51.100.10
            - 2001:db8:1::10
          type: array
          items:
            type: string
        tsigKey:
          description: >-
            Neuen TSIG-Schlüssel setzen (ersetzt einen vorhandenen). Weglassen =
            unverändert.
          anyOf:
            - $ref: '#/components/schemas/TsigKeyInput-zone.secondary-write'
            - type: 'null'
        removeTsigKey:
          description: '`true` entfernt den TSIG-Schlüssel.'
          default: false
          type: boolean
    Zone.SecondaryZoneView-zone.secondary:
      type: object
      properties:
        zoneId:
          default: ''
          example: A1B2C3D4E5F6G7H8I9J0
          type: string
        zone:
          default: ''
          example: example.com
          type: string
        masterIpAddresses:
          description: IP-Adressen des Master-Nameservers des Kunden.
          example:
            - 198.51.100.10
          type: array
          items:
            type: string
        tsigAlgorithm:
          description: Algorithmus des TSIG-Schlüssels, `null` ohne TSIG.
          example: hmac-sha256
          type:
            - string
            - 'null'
        state:
          description: >-
            `pending`: Transfer steht aus. `ok`: übertragen und aktuell.
            `stale`: Master länger nicht erreichbar. `failed`: noch nie
            übertragen. `unknown`: Status nicht abrufbar.
          default: unknown
          example: ok
          type: string
          enum:
            - pending
            - ok
            - stale
            - failed
            - unknown
        stateMessage:
          description: Erklärung des Zustands für den Kunden (deutsch).
          default: ''
          type: string
        serial:
          description: SOA-Serial des übertragenen Stands, `null` = noch nie übertragen.
          example: 2026112101
          type:
            - integer
            - 'null'
        lastCheckAt:
          description: Letzte erfolgreiche Prüfung beim Master (ISO 8601).
          example: '2026-11-21T10:00:00+00:00'
          type:
            - string
            - 'null'
        lastTransferAt:
          description: >-
            Zeitpunkt, zu dem zuletzt ein neuer Stand übertragen wurde (ISO
            8601).
          example: '2026-11-21T09:00:00+00:00'
          type:
            - string
            - 'null'
        retrieveRequestedAt:
          description: Letzter angestoßener Abruf (ISO 8601).
          type:
            - string
            - 'null'
        retrieveAvailableAt:
          description: Ab wann ein erneuter Abruf möglich ist (ISO 8601), `null` = sofort.
          type:
            - string
            - 'null'
        live:
          description: >-
            `true`: Status eben bei unseren Nameservern gelesen. `false`:
            letzter gespeicherter Stand.
          default: false
          type: boolean
        checkedAt:
          description: Zeitpunkt des angezeigten Status (ISO 8601).
          type:
            - string
            - 'null'
        records:
          description: >-
            Übertragene Records (nur lesbar). `name` relativ zur Zone. SOA
            fehlt, die Apex-NS stehen als NS-Records darin.
          type: array
          items:
            type: object
            additionalProperties:
              anyOf:
                - type: integer
                - type: string
        notConvertible:
          description: >-
            Übertragene Einträge, die eine normale Zone bei uns nicht führen
            kann (z. B. DNSSEC-Signaturen). Solange es welche gibt, ist keine
            Umwandlung möglich.
          type: array
          items:
            type: object
            additionalProperties:
              type: string
        axfrSourceIps:
          description: >-
            Von diesen Adressen holen unsere Nameserver die Zone. Dein Master
            muss AXFR/IXFR von dort erlauben.
          example:
            - 192.0.2.53
            - 2001:db8::53
          type: array
          items:
            type: string
        notifyTargetIps:
          description: An diese Adressen schickt dein Master NOTIFY.
          example:
            - 192.0.2.53
          type: array
          items:
            type: string
        featureEnabled:
          description: >-
            Ist sekundäres DNS für den Kunden freigeschaltet? Ohne Freischaltung
            gehen nur Lesen und Löschen.
          default: false
          type: boolean
        actions:
          description: Welche Aktionen gerade möglich sind.
          default:
            retrieve: false
            update: false
            convert: false
          example:
            retrieve: true
            update: true
            convert: true
          type: object
          additionalProperties:
            type: boolean
    Error:
      type: object
      description: A representation of common errors.
      properties:
        title:
          readOnly: true
          description: A short, human-readable summary of the problem.
          type:
            - string
            - 'null'
        detail:
          readOnly: true
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          type:
            - string
            - 'null'
        status:
          type:
            - integer
            - 'null'
          examples:
            - 404
          default: 400
        instance:
          readOnly: true
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem. It may or may not yield further information if
            dereferenced.
          type:
            - string
            - 'null'
        type:
          readOnly: true
          description: A URI reference that identifies the problem type
          type: string
    ConstraintViolation:
      type: object
      description: Unprocessable entity
      properties:
        status:
          default: 422
          type: integer
        violations:
          type: array
          items:
            type: object
            properties:
              propertyPath:
                type: string
                description: The property path of the violation
              message:
                type: string
                description: The message associated with the violation
              code:
                type: string
                description: The code of the violation
              hint:
                type: string
                description: An extra hint to understand the violation
              payload:
                type: object
                additionalProperties: true
                description: The serialized payload of the violation
            required:
              - propertyPath
              - message
        detail:
          readOnly: true
          type: string
        type:
          readOnly: true
          type: string
        title:
          readOnly: true
          type:
            - string
            - 'null'
        instance:
          readOnly: true
          type:
            - string
            - 'null'
    TsigKeyInput-zone.secondary-write:
      type: object
      properties:
        name:
          description: Schlüsselname wie auf dem Master. Muss bei uns eindeutig sein.
          default: ''
          example: example-com-axfr
          type: string
        algorithm:
          default: hmac-sha256
          example: hmac-sha256
          type: string
          enum:
            - hmac-sha256
            - hmac-sha384
            - hmac-sha512
        secret:
          description: Geheimnis, Base64.
          default: ''
          example: c2VjcmV0LXNlY3JldC1zZWNyZXQtc2VjcmV0IQ==
          type: string
  securitySchemes:
    JWT:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        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.
    ApiToken:
      type: apiKey
      in: header
      name: X-API-TOKEN
      description: >-
        Persönlicher API-Token für Skripte, CI/CD und
        Server-zu-Server-Integrationen, gesendet im Header `X-API-TOKEN:
        <token>`.


        Tokens werden im Kundenpanel unter **Einstellungen → Sicherheit**
        angelegt oder per `POST /user/api-tokens` mit einem gültigen JWT. Der
        Klartext erscheint nur einmal in der Antwort beim Anlegen. Ein Token
        handelt mit den Rechten des Benutzers, der ihn erstellt hat, kann ein
        Ablaufdatum haben und wird mit `DELETE /user/api-tokens/{id}` sofort
        widerrufen.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.