Wie bearbeite ich ein Asset?

Ab Tarif Basic

Kurzantwort

Öffne das Asset, klicke auf „Bearbeiten”, ändere die gewünschten Felder und speichere. Außer Typ und Name sind alle Felder optional und jederzeit änderbar. Per API genügt ein PUT mit nur den geänderten Feldern. Alles andere bleibt unverändert.

Voraussetzungen

Das Asset-Modul ist im Kern enthalten und in allen Tarifen verfügbar. Für das Bearbeiten gilt kein Asset-Limit. Das greift nur bei der Neuanlage.

Asset öffnen. Wähle in der linken Navigation Assets und klicke die gewünschte Zeile an. Du landest in der Detailansicht. Oben rechts liegt die Schaltfläche „Bearbeiten”.

Screenshot ausstehend assets-bearbeiten-01 Detailansicht eines Assets mit hervorgehobener Schaltfläche 'Bearbeiten' oben rechts

Die Detailansicht eines Assets mit der Schaltfläche 'Bearbeiten'.
Felder ändern. Es öffnet sich das vorbefüllte Formular. Passe die Felder an, z. B. Status, Standort, Abteilung, Zugewiesen an oder die Angaben unter Finanzen & Lebenszyklus.

Screenshot ausstehend assets-bearbeiten-02 Vorbefülltes Asset-Formular im Bearbeiten-Modus

Das Asset-Formular öffnet vorbefüllt. Nur geänderte Felder werden übernommen.
Speichern. Klicke auf „Speichern”. Die Änderungen werden übernommen und du kehrst in die Detailansicht zurück.

Dieselbe Aktion per REST-API: ein PUT auf /api/v1/assets/{id} mit einem Bearer-Token (Scope write). Sende nur die Felder, die sich ändern sollen. Alle Felder sind optional.

curl -X PUT https://demo.notory.io/api/v1/assets/a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55 \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "maintenance",
    "location": "Büro München / Raum 2.14",
    "department": "IT"
  }'

Bei Erfolg antwortet die API mit HTTP 200 OK und dem vollständigen, aktualisierten Asset (gekürzt):

{
  "id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55",
  "name": "ThinkPad T14 – Vertrieb",
  "status": "maintenance",
  "location": "Büro München / Raum 2.14",
  "department": "IT",
  "updated_by": "b7c3…",
  "updated_at": "2026-07-08T10:02:11Z"
}

Mögliche Fehler: 401 (Token fehlt/ungültig), 404 (Asset gehört nicht zu deinem Mandanten oder existiert nicht), 422 (Validierung, z. B. leerer name, unbekannter status/asset_type oder ein ungültiger Freifeld-Wert).

Was passiert dabei?

Teilaktualisierung: Nur die übergebenen Felder werden geschrieben; alles andere bleibt erhalten (AssetUpdate, alle Felder optional).
Audit-Trail: Du wirst als letzter Bearbeiter vermerkt (updated_by, updated_at); der ursprüngliche Ersteller bleibt unverändert. Der Tab Verlauf in der Detailansicht führt die Aktivitäten zum Asset.
Mandanten-Isolation: Du kannst nur Assets deines eigenen Mandanten ändern; ein fremdes Asset führt zu 404.
Freifeld-Validierung: Übergibst du custom_fields, werden sie gegen die im Mandanten definierten Freifelder (entity_type = asset) geprüft, siehe Freifelder definieren.
Buchwert: Änderst du Abschreibungsfelder (Kosten, Restwert, Methode, Nutzungsdauer), wird der aktuelle Buchwert (current_book_value) neu berechnet.
Kein Limit-Check: Das Asset-Limit der Lizenz wird beim Bearbeiten nicht geprüft (nur bei der Neuanlage).