NetBird Full API Reference + Read-Only MCP Prototype
PUT/api/integrations/edr/fleetdm

Replace the EDR FleetDM integration configuration

Replaces the configuration of an existing EDR FleetDM integration. Supply the FleetDM server URL and API token, applicable groups, device sync interval, and match_attributes used to approve hosts.

7 body fields

EDR FleetDM integration configuration. api_url, api_token, groups, last_synced_interval, and match_attributes are required.

api_tokenstringrequired
FleetDM API token
api_urlstringrequired
FleetDM server URL
enabledbooleanoptional
Indicates whether the integration is enabled
Default:true
groupsarray<string>required
The Groups this integrations applies to
last_synced_intervalintegerrequired
The devices last sync requirement interval in hours. Minimum value is 24 hours
match_attributesobjectrequired
Attribute conditions to match when approving FleetDM hosts. Most attributes work with FleetDM's free/open source version. Premium-only attributes are marked accordingly
sync_intervalintegeroptional
How often devices are synced from the integration, in minutes. Minimum value is 1 minute, maximum is 1440 minutes.

5 status codes
200Returns the updated EDR FleetDM integration, including its identifier, account and creator identifiers, server URL, sync configuration, groups, match attributes, enabled state, and timestamps.
account_idstringrequired
The identifier of the account this integration belongs to.
api_urlstringrequired
FleetDM server URL
created_atstringrequired
Timestamp of when the integration was created.
created_bystringrequired
The user id that created the integration
enabledbooleanrequired
Indicates whether the integration is enabled
Default:true
groupsarray<object>required
List of groups
idintegerrequired
The unique numeric identifier for the integration.
last_synced_atstringrequired
Timestamp of when the integration was last synced.
last_synced_intervalintegerrequired
The devices last sync requirement interval in hours.
match_attributesobjectrequired
Attribute conditions to match when approving FleetDM hosts. Most attributes work with FleetDM's free/open source version. Premium-only attributes are marked accordingly
sync_intervalintegerrequired
How often devices are synced from the integration, in minutes.
updated_atstringrequired
Timestamp of when the integration was last updated.
400Returned when the request contains invalid JSON, omits required fields, or fails validation.
messagestringoptional
A human-readable error message.
401Returned when the request is unauthorized.
messagestringoptional
A human-readable error message.
404Returned when the integration is not found.
messagestringoptional
A human-readable error message.
500Returned when an internal server error occurs.
messagestringoptional
A human-readable error message.

Error handling

A 400 is returned for malformed JSON, invalid values, or missing required fields; a 401 for an unauthorized request; a 404 when the integration is not found; and a 500 for an internal server error. The body must include api_url, api_token, groups, last_synced_interval, and match_attributes; last_synced_interval must be at least 24 hours, and sync_interval must be between 1 and 1440 minutes when supplied.