---
title: "Objekt ändern"
url: "https://maklerportal.apim.eu/apis/objektverwaltung/versions/725feb93-ed74-4ebf-862d-00afd038d14d/operations/objektAendern"
---

> Full API specification: https://maklerportal.apim.eu/apis/objektverwaltung/versions/725feb93-ed74-4ebf-862d-00afd038d14d.md

# Objekt ändern

`PATCH` `/objekte/{objektId}`

Operation ID: `objektAendern`

Ändert einzelne Felder. Bereits erzeugte Exposés bleiben unverändert.

## Path parameters

- `objektId` (string, required)

## Request body (required)

Content types: `application/json`

## Responses

- `200` - Geändert
- `404` - Datensatz nicht gefunden

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Objektverwaltung
  version: 1.0.0
servers:
  - url: https://api.maklerportal.example/v1
    description: Produktion
  - url: https://sandbox.api.maklerportal.example/v1
    description: Sandbox
paths:
  /objekte/{objektId}:
    parameters:
      - name: objektId
        in: path
        required: true
        schema:
          type: string
          example: obj_8f2c1a
    patch:
      tags:
        - Objekte
      summary: Objekt ändern
      description: Ändert einzelne Felder. Bereits erzeugte Exposés bleiben unverändert.
      operationId: objektAendern
      security:
        - apiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/ObjektAnlegen"
            example:
              kaufpreis_eur: 629000
      responses:
        "200":
          description: Geändert
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Objekt"
        "404":
          $ref: "#/components/responses/NichtGefunden"
security:
  - apiKey: []
components:
  schemas:
    ObjektAnlegen:
      type: object
      required:
        - typ
        - titel
        - adresse
      properties:
        typ:
          $ref: "#/components/schemas/Objekttyp"
        titel:
          type: string
          maxLength: 120
          example: 3-Zimmer-Altbau am Falkenried
        beschreibung:
          type: string
          example: Gepflegte Altbauwohnung im zweiten Obergeschoss mit zwei Südbalkonen.
        adresse:
          $ref: "#/components/schemas/Adresse"
        wohnflaeche_qm:
          type: number
          format: float
          example: 86.5
        grundstuecksflaeche_qm:
          type: number
          format: float
          example: 412
        zimmer:
          type: number
          format: float
          example: 3
        baujahr:
          type: integer
          example: 1908
        etage:
          type: integer
          example: 2
        kaufpreis_eur:
          type: integer
          example: 645000
        kaltmiete_eur:
          type: integer
          example: 1450
        nebenkosten_eur:
          type: integer
          example: 280
        verfuegbar_ab:
          type: string
          format: date
          example: 2026-11-01
        energieausweis:
          $ref: "#/components/schemas/Energieausweis"
        provision:
          $ref: "#/components/schemas/Provision"
    Objekt:
      allOf:
        - $ref: "#/components/schemas/ObjektAnlegen"
        - type: object
          properties:
            id:
              type: string
              example: obj_8f2c1a
            status:
              $ref: "#/components/schemas/ObjektStatus"
            medien_anzahl:
              type: integer
              example: 14
            angelegt_am:
              type: string
              format: date-time
              example: 2026-08-14T08:12:44Z
            geaendert_am:
              type: string
              format: date-time
              example: 2026-08-20T09:38:02Z
    Objekttyp:
      type: string
      enum:
        - wohnung
        - haus
        - grundstueck
        - gewerbe
        - stellplatz
      example: wohnung
    Adresse:
      type: object
      required:
        - plz
        - ort
      properties:
        strasse:
          type: string
          example: Falkenried 42
        plz:
          type: string
          pattern: ^[0-9]{5}$
          example: "20251"
        ort:
          type: string
          example: Hamburg
        land:
          type: string
          default: DE
        lage_genauigkeit:
          type: string
          description: Steuert, wie genau die Adresse im Exposé erscheint.
          enum:
            - exakt
            - strasse
            - stadtteil
          default: strasse
    Energieausweis:
      type: object
      description: Kennwerte, die für die Veröffentlichung eines Exposés benötigt werden.
      properties:
        art:
          type: string
          enum:
            - verbrauchsausweis
            - bedarfsausweis
        endenergiebedarf_kwh:
          type: number
          format: float
          example: 118.4
        energietraeger:
          type: string
          example: fernwaerme
        baujahr_anlage:
          type: integer
          example: 1998
        effizienzklasse:
          type: string
          enum:
            - A+
            - A
            - B
            - C
            - D
            - E
            - F
            - G
            - H
        gueltig_bis:
          type: string
          format: date
          example: 2031-04-30
        befreiung:
          type: string
          description: Gesetzt, wenn keine Ausweispflicht besteht.
          enum:
            - denkmalschutz
            - kleingebaeude
    Provision:
      type: object
      properties:
        kaeufer_prozent:
          type: number
          format: float
          example: 3.57
        verkaeufer_prozent:
          type: number
          format: float
          example: 3.57
        hinweis:
          type: string
          example: inkl. gesetzlicher Umsatzsteuer
    ObjektStatus:
      type: string
      enum:
        - entwurf
        - aktiv
        - reserviert
        - verkauft
        - vermietet
        - archiviert
      example: aktiv
    Fehler:
      type: object
      description: Einheitliches Fehlerformat aller Maklerportal-APIs.
      required:
        - code
        - nachricht
      properties:
        code:
          type: string
          example: validierung_fehlgeschlagen
        nachricht:
          type: string
          example: Für die Veröffentlichung fehlen Pflichtangaben aus dem Energieausweis.
        details:
          type: array
          items:
            $ref: "#/components/schemas/Fehlerdetail"
    Fehlerdetail:
      type: object
      properties:
        feld:
          type: string
          example: energieausweis.endenergiebedarf_kwh
        grund:
          type: string
          example: fehlt
  responses:
    NichtGefunden:
      description: Datensatz nicht gefunden
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/Fehler"
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: apikey
      description: >
        Jeder Aufruf trägt einen API-Schlüssel im Header `apikey`. Den Schlüssel

        erzeugen Sie im Maklerportal unter "Meine Anwendungen"; er wird genau
        einmal

        angezeigt.


        An jedem Schlüssel hängen die Scopes, die er nutzen darf. Fehlt einer,

        antwortet die API mit `403` und `code: "scope_fehlt"`; der fehlende
        Scope

        steht in `details[].feld`.
```