How do I assign an IP address to an asset?

Requires Basic

Quick answer

In the Network module, open the relevant IP address for editing, choose the device under Assigned asset, and set the status to Assigned. You can also fill in both fields directly when creating the address.

Prerequisites

Included in all plans from Basic onward.

Open the IP address for editing. Choose Network → IP Addresses and open the desired address via the row menu (or create it anew).
Set the asset and status.
- Assigned asset — choose the device that uses the address.
- Status — set it to Assigned.
Screenshot pending netzwerk-ip-zuordnen-01 IP address form with 'Assigned asset' selected and status set to 'Assigned'

Editing an IP address: select the asset and set the status to 'Assigned'.
Save. The list now shows the address as Assigned, along with the linked asset.

For an existing address, you set both fields via PUT to /api/v1/network/ips/{id}. Only the fields you send are overwritten.

curl -X PUT https://demo.notory.io/api/v1/network/ips/0190f3a2-6c11-7b8e-9f2a-1c4d5e6f7a80 \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "assigned_asset_id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55",
    "status": "assigned"
  }'

{
  "id": "0190f3a2-6c11-7b8e-9f2a-1c4d5e6f7a80",
  "address": "10.0.0.10",
  "status": "assigned",
  "assigned_asset_id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55",
  "updated_at": "2026-07-08T09:45:00Z"
}

When creating an address, you can supply assigned_asset_id and status directly in the POST /api/v1/network/ips call.

Possible errors: 401, 403 (no write access), 404 (IP not found), 422 (invalid status).

What happens behind the scenes?

Two separate fields: Notory doesn’t couple asset assignment and status automatically. Setting Assigned asset does not change the status by itself — set Assigned deliberately alongside it, so the address is correctly counted as occupied in reports and in the search for free IPs.
Audit trail: The change records you as the last editor (updated_by) along with a timestamp.
Stable link: If the asset is later deleted, Notory sets assigned_asset_id to null (SET NULL). The status remains unchanged — you should then set the address back to Available.