# Mist Orgs User MACs API

**Canonical:** https://apis.io/apis/mist/mist-orgs-user-macs-api/  
**Provider:** Mist — https://apis.io/providers/mist/  
**Base URL:** https://api.mist.com/api/v1  
**Documentation:** https://www.juniper.net/documentation/us/en/software/mist/automation-integration/

Mist Orgs User MACs API is one of 212 APIs that [Mist](https://apis.io/providers/mist/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Orgs User MACs. The published artifact set on APIs.io includes an OpenAPI specification.

NAC User MACs (Endpoints) provide a database of endpoints identified by their MAC addresses. They can be used assign each endpoint with various attributes, such as name, VLAN, role and client label. Once an endpoint is labeled, the label name can be used to create [NAC Tags]($h/Orgs%20NAC%20Tags/_overview) as match criteria. [NAC Tags]($h/Orgs%20NAC%20Tags/_overview) can be used to create Tags regrouping one or multiple endpoint MAC addresses, but the use of the User MACs provides additional features: * possibility to assign specific attributes, like a Name, a RADIUS Group, a VLAN ID, ... * possibility to assign one or multiple Tags (Labels) to a User MAC * improved management for large list of MAC addresses

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/orgs/{org_id}/usermacs` | createOrgUserMac |
| PUT | `/api/v1/orgs/{org_id}/usermacs` | updateOrgMultipleUserMacs |
| GET | `/api/v1/orgs/{org_id}/usermacs/count` | countOrgUserMacs |
| POST | `/api/v1/orgs/{org_id}/usermacs/delete` | deleteOrgMultipleUserMacs |
| POST | `/api/v1/orgs/{org_id}/usermacs/import` | importOrgUserMacs |
| GET | `/api/v1/orgs/{org_id}/usermacs/search` | searchOrgUserMacs |
| DELETE | `/api/v1/orgs/{org_id}/usermacs/{usermac_id}` | deleteOrgUserMac |
| GET | `/api/v1/orgs/{org_id}/usermacs/{usermac_id}` | getOrgUserMac |
| PUT | `/api/v1/orgs/{org_id}/usermacs/{usermac_id}` | updateOrgUserMac |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/mist/refs/heads/main/openapi/mist-orgs-user-macs-api-openapi.yml

## Other Mist APIs (12)

- [Mist Admins API](https://apis.io/apis/mist/mist-admins-api/)
- [Mist Admins Login API](https://apis.io/apis/mist/mist-admins-login-api/)
- [Mist Admins Login - OAuth2 API](https://apis.io/apis/mist/mist-admins-login-oauth2-api/)
- [Mist Admins Logout API](https://apis.io/apis/mist/mist-admins-logout-api/)
- [Mist Admins Lookup API](https://apis.io/apis/mist/mist-admins-lookup-api/)
- [Mist Admins Recover Password API](https://apis.io/apis/mist/mist-admins-recover-password-api/)
- [Mist Constants Definitions API](https://apis.io/apis/mist/mist-constants-definitions-api/)
- [Mist Constants Events API](https://apis.io/apis/mist/mist-constants-events-api/)
- [Mist Constants Models API](https://apis.io/apis/mist/mist-constants-models-api/)
- [Mist Installer API](https://apis.io/apis/mist/mist-installer-api/)
- [Mist MSPs Admins API](https://apis.io/apis/mist/mist-msps-admins-api/)
- [Mist MSPs API](https://apis.io/apis/mist/mist-msps-api/)

## Tags

Orgs User MACs

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/mist/mist-orgs-user-macs-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/mist/.