Assets

Every device you track appears as an asset on the Blecon Track map — whether it's a forklift, a medical device, or a delivery van. Assets give you a single view of where things are, where they've been, and what zone they're in, so you can make decisions based on real-time location data instead of manual checks.

What you see

Each asset shows:

Current position — Where the device is right now, displayed on the live map.
Last seen — When the device last reported a position.
Zone — Which zone the device is currently in (if any).
Status — Whether the device is active (recently seen) or inactive.
Trail — The movement path over a selected time period.

The assets list

The assets list shows all tracked devices in your workspace. You can filter by:

Name or ID — Free-text search across asset names and device IDs.
Status — Active (seen in the last 15 minutes) or offline.
Zone — Assets in a specific zone, in any zone, or in no zone.
Asset type — Category like "vehicle", "equipment", or "pallet".
Tag — Any tag assigned to the asset (see Tags below).
Association status — Whether the asset has a parent or children.

Click any asset to open its detail page with position history, sensor data, and association information.

Asset details

The detail page for an asset includes:

Position history — A timeline of all recorded positions with timestamps.
Sensor data — Temperature, humidity, battery level, and other sensor readings (when available).
Associations — Parent and child relationships with other assets.
Zone transitions — When the device entered and left each zone.
Tags — Free-form labels you can add and remove inline (see below).
Custom fields — Key-value metadata set when the asset was added or updated via the API.

Asset types

Every asset can have a type — a single category like "vehicle", "case", or "pallet". Types are free-form: you type a value and it becomes available for other assets in the same workspace. The assets list shows a Type column and filter dropdown when at least one asset has a type set.

Types are useful when your assets fall into a small number of distinct categories that don't change often. For more flexible grouping, use tags.

Tags

Tags are free-form labels you attach to assets for filtering and grouping. Unlike asset types (one per asset), an asset can have any number of tags.

Examples: floor-2, high-value, maintenance-due, building-a, customer-acme

Adding and removing tags

On the asset detail page, you'll see a Tags row below the stats bar. Type a tag name and press Enter to add it. Click the × on any tag to remove it. Changes save immediately.

When adding an asset (via the Add Asset dialog or the API), you can set initial tags at the same time.

Filtering by tag

On the assets list, a Tags dropdown appears when any asset in your workspace has at least one tag. Select a tag to filter the list to only assets with that tag.

You can also click a tag chip on any asset row to instantly filter by that tag.

Tags via the API

Tags are a string array on the asset resource. Set them when creating or updating an asset:

# Add an asset with tags
curl -X POST https://api.blecon.net/tracker/api/workspaces/{workspace_id}/assets \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "asset_id": "urn:uuid:550e8400-e29b-41d4-a716-446655440000",
    "asset_name": "Forklift #3",
    "asset_type": "vehicle",
    "tags": ["warehouse-b", "high-value"]
  }'

# Update tags on an existing asset
curl -X PATCH https://api.blecon.net/tracker/api/workspaces/{workspace_id}/assets/{asset_id} \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["warehouse-b", "high-value", "maintenance-due"]}'

# Filter the asset list by tag
curl "https://api.blecon.net/tracker/api/workspaces/{workspace_id}/assets?tag=high-value" \
  -H "Authorization: Bearer {api_key}"

# List all tags in use
curl "https://api.blecon.net/tracker/api/workspaces/{workspace_id}/tags" \
  -H "Authorization: Bearer {api_key}"

Setting tags replaces the entire tag list. To add a tag, include all existing tags plus the new one. To remove a tag, send the list without it.

Custom fields

Custom fields let you store arbitrary key-value metadata on each asset — serial numbers, departments, purchase dates, or any other information your workflow needs.

Custom fields are set via the metadata object when creating or updating an asset:

curl -X POST https://api.blecon.net/tracker/api/workspaces/{workspace_id}/assets \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "asset_id": "urn:uuid:550e8400-e29b-41d4-a716-446655440000",
    "asset_name": "Forklift #3",
    "metadata": {
      "serial_number": "FL-003",
      "department": "warehouse",
      "purchase_date": "2024-06-15"
    }
  }'

Custom fields appear on the asset detail page under the Custom Fields heading. The keys are displayed as labels and the values alongside them.

You can also add and remove custom fields directly on the asset detail page — click the edit icon next to the Custom Fields heading.