OrgsUser MACs
importOrgUserMacs
Import Org User MACs. Accepts JSON or CSV upload.
JSON — Array form (asynchronous by default):
[ {"mac": "921b638445cd", "labels": ["label1"], "vlan": "vlan-1"}, {"mac": "721b638445ef", "labels": ["label2", "label3"], "notes": "mac address refers to Canon printers"}]CSV upload: multipart/form-data with file field.
CSV file format
mac,labels,vlan,notes,name,radius_group921b638445cd,"bldg1,flor1",vlan-100721b638445ef,"bldg2,flor2",vlan-101,Canon Printers721b638445ee,"bldg3,flor3",vlan-102,Printer2,VIP921b638445ce,"bldg4,flor4",vlan-103921b638445cf,"bldg5,flor5",vlan-104Authorization<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
Format
uuidList of user MAC entries
[index: integer]?
Organization user MAC entry
Response Body
curl -X POST "https://example.com/api/v1/orgs/000000ab-00ab-00ab-00ab-0000000000ab/usermacs/import" \ -H "Content-Type: application/json" \ -d '[ { "labels": [ "label1" ], "mac": "921b638445cd", "vlan": "vlan-1" }, { "labels": [ "label2", "label3" ], "mac": "721b638445ef", "notes": "mac address refers to Canon printers" }, { "labels": [ "label4" ], "mac": "721b638445ee" }, { "labels": [ "label5", "label6", "label7" ], "mac": "921b638445ce" }, { "mac": "921b638445cf", "vlan": "vlan-100" } ]'{ "detail": "import in progress"}