Download agent configuration

GET

/v1/agent/config

Code sample: cURL

curl --request GET \
  --url 'https://api.furl.ai/v1/agent/config?platform=linux&profile=config&tags=production,web%20servers' \
  --remote-name --remote-header-name \
  --header 'Authorization: Bearer YOUR_API_KEY'

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.

tags

Array<string>

<= 5 items

Comma-separated list of tag names to embed in the agent config (maximum 5). Endpoints using this config will have these tags synced as agent-based tags during each status update. Requesting more than 5 tags returns 400.

Responses

200

Signed agent configuration file.

Media typeapplication/octet-stream

string format: binary

400

Invalid platform/profile combination.

Media typeapplication/json

object

error

required

Human-readable error message.

string

Example^generated

{
  "error": "example"
}

401

Missing or invalid API key.

Media typeapplication/json

object

error

required

Human-readable error message.

string

Example^generated

{
  "error": "example"
}

404

Enrollment secret not configured for organization.

Media typeapplication/json

object

error

required

Human-readable error message.

string

Example^generated

{
  "error": "example"
}

500

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

Media typeapplication/json

object

error

required

Human-readable error message.

string

Example^generated

{
  "error": "example"
}