SitesAuto Map Assignment

clearSiteAutoMapAssignment

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

Clear (reject) auto map assignment results for a site without applying them. The cached assignment results are cleared. Omit map_ids or provide an empty list to reject all pending assignments; provide specific map_ids for a partial reject.

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/clear_auto_map_assignment" \  -H "Content-Type: application/json" \  -d '{}'
{  "message": "Rejected map assignments for map_ids: ['d3c42998-9012-4859-9743-6b9bee475309', 'f7a21456-7891-4abc-def0-123456789abc']",  "rejected_maps": [    "d3c42998-9012-4859-9743-6b9bee475309",    "f7a21456-7891-4abc-def0-123456789abc"  ]}