SitesAuto Map Assignment

applySiteAutoMapAssignment

POST
/api/v1/sites/{site_id}/apply_auto_map_assignment

Apply (accept) auto map assignment results for a site. Devices are associated with their assigned maps. Omit map_ids or provide an empty list to accept all pending assignments; provide specific map_ids for a partial accept.

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

site_id*string
Formatuuid

Request Body

application/json

Request Body

Request body for accepting or clearing pending map assignments

map_ids?array<>

Optional list of specific map IDs to apply/clear. If not provided or empty, all pending map assignments are accepted/rejected.

Response Body

curl -X POST "https://example.com/api/v1/sites/000000ab-00ab-00ab-00ab-0000000000ab/apply_auto_map_assignment" \  -H "Content-Type: application/json" \  -d '{}'
{  "accepted_maps": [    "d3c42998-9012-4859-9743-6b9bee475309",    "f7a21456-7891-4abc-def0-123456789abc"  ],  "message": "Accepted map assignments for map_ids: ['d3c42998-9012-4859-9743-6b9bee475309', 'f7a21456-7891-4abc-def0-123456789abc']"}