How do I assign an asset to a location or rack?

Requires Pro

Quick answer

An asset is placed via its own Location and Rack position fields — you open the asset for editing and enter where it physically resides. These fields are free text: they are not hard-linked to the objects in the Infrastructure module. So use the exact label of your recorded locations and racks as the value, to keep search and reporting consistent.

Prerequisites

Editing assets is part of the Asset module (all plans from Basic onward). The structured management of locations and racks — from which you take the labels — is part of the Infrastructure module (Pro plan).

Open the asset for editing. Choose Assets, open the desired device, and click Edit.
Enter the location and rack position.
- Location — where the asset is physically kept, e.g. “Munich Headquarters / DC-1”.
- Rack position — e.g. “Rack A01 / U 12–14”.
- Department (optional) — the responsible team.
Screenshot pending infrastruktur-asset-verorten-01 Asset form with the Location and Rack Position fields filled in

Setting the 'Location' and 'Rack Position' fields on the asset.
Save. The asset shows its placement in the detail view and is discoverable via these fields.

You set the placement on the asset via PUT to /api/v1/assets/{id} — only the fields you send are overwritten.

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 '{
    "location": "Hauptsitz Muenchen / RZ-1",
    "rack_position": "Rack A01 / HE 12-14",
    "department": "IT-Betrieb"
  }'

{
  "id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55",
  "name": "ThinkPad T14 – Vertrieb",
  "location": "Hauptsitz Muenchen / RZ-1",
  "rack_position": "Rack A01 / HE 12-14",
  "department": "IT-Betrieb",
  "updated_at": "2026-07-08T10:20:00Z"
}

Possible errors: 401, 403 (no write access), 404 (asset not found), 422 (validation).

What happens behind the scenes?

Free text instead of a hard link: location and rack_position are text fields on the asset — there is no foreign-key relationship to the objects in the Infrastructure module. If you delete or rename a location/rack there, the text on the asset does not change automatically.
Consistency through convention: For reports to group cleanly, carry over the exact spelling of your structured locations and racks. A consistent scheme such as “Location / Data center” or “Rack / height-unit range” has proven effective.
Audit trail: The change records you as the last editor (updated_by) along with a timestamp.