Fortinet black logo

REST API Solution Guide

MAC groups (/macgroups/)

MAC groups (/macgroups/)

URL: https://[server_name]/api/v1/macgroups/

This endpoint represents MAC device group resource.

Supported fields

Field Display name Type Required Other restrictions
name MAC group name String Yes Max length = 50.
devices MAC address list No List of MAC devices URI. Read only.

Allowed methods

HTTP method Resource URI Action
GET /api/v1/macgroups/ Get all MAC device groups.
GET /api/v1/macgroups/[id]/ Get MAC device group with ID.

POST

/api/v1/macgroups/

Create a new MAC device group.

DELETE

/api/v1/macgroups/[id]/ Delete MAC device with ID.

Allowed filters

Field Lookup expressions Values
name exact

MAC groups (/macgroups/)

URL: https://[server_name]/api/v1/macgroups/

This endpoint represents MAC device group resource.

Supported fields

Field Display name Type Required Other restrictions
name MAC group name String Yes Max length = 50.
devices MAC address list No List of MAC devices URI. Read only.

Allowed methods

HTTP method Resource URI Action
GET /api/v1/macgroups/ Get all MAC device groups.
GET /api/v1/macgroups/[id]/ Get MAC device group with ID.

POST

/api/v1/macgroups/

Create a new MAC device group.

DELETE

/api/v1/macgroups/[id]/ Delete MAC device with ID.

Allowed filters

Field Lookup expressions Values
name exact