Download agent configuration

GET

/v1/agent/config

• Production
• Development
• Local development

Generate and download a signed agent configuration file for the specified platform and profile type. The organization is determined by the API key.

Authorizations

• bearerAuth

Parameters

Query Parameters

platform

required

string

Allowed values: linux macos windows

Target operating system.

profile

string

default: config

Allowed values: config mdm-full mdm-permissions

Output profile type. “config” returns platform-native config files. “mdm-full” returns a macOS .mobileconfig with config and permissions. “mdm-permissions” returns a macOS .mobileconfig with permissions only. MDM profiles are only valid for platform=macos.

Responses

200

Signed agent configuration file.

string format: binary

400

Invalid platform/profile combination.

object

error

required

Human-readable error message.

string

401

Missing or invalid API key.

object

error

required

Human-readable error message.

string

404

Enrollment secret not configured for organization.

object

error

required

Human-readable error message.

string

500

Internal server error (e.g., KMS signing failure).

object

error

required

Human-readable error message.

string