OrgsAssets

createOrgAsset

POST
/api/v1/orgs/{org_id}/assets

Create a named BLE asset record with a Bluetooth MAC address and optional site, map, or tag metadata.

Authorization

Authorization<token>

Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header.

Format: Authorization: Token {apitoken}

Notes:

  • An API token generated for a specific admin has the same privileges as that admin
  • An API token is automatically removed if it is not used for more than 90 days
  • SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.

In: header

Path Parameters

org_id*string
Formatuuid

Request Body

application/json

Request Body

Named Bluetooth Low Energy asset record

mac*string

Bluetooth MAC address used to identify the BLE asset

map_id?string

Identifier of the map associated with this asset, when specified

Formatuuid
name*string

Display name or label for the BLE asset

tag_id?string

BLE tag identifier associated with this asset

Formatuuid

Response Body

curl -X POST "https://example.com/api/v1/orgs/000000ab-00ab-00ab-00ab-0000000000ab/assets" \  -H "Content-Type: application/json" \  -d '{    "mac": "string",    "name": "string"  }'
{  "created_time": 0,  "id": "b069b358-4c97-5319-1f8c-7c5ca64d6ab1",  "mac": "string",  "map_id": "b069b358-4c97-5319-1f8c-7c5ca64d6ab1",  "modified_time": 0,  "name": "string",  "org_id": "b069b358-4c97-5319-1f8c-7c5ca64d6ab1",  "site_id": "b069b358-4c97-5319-1f8c-7c5ca64d6ab1",  "tag_id": "6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9"}