> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argalabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Iru / Kandji

> Iru / Kandji Scenario seeding parameters, nested fields, and examples

Use `kandji` in `twins` and put this configuration under `seed_config.kandji`.

Iru Endpoint Management (formerly Kandji) with enrolled devices, users, Blueprints, tags, custom apps, custom profiles, custom scripts, device inventory, security findings, and actions.

## Example seed

This is the complete Scenario request body for [creating a Scenario](https://docs.argalabs.com/api-reference/post-create-a-scenario.md). You can also import it with `arga test-runner scenarios import --file scenario.json`.

```json theme={null}
{
  "name": "Iru / Kandji eval fixture",
  "twins": [
    "kandji"
  ],
  "seed_config": {
    "kandji": {
      "blueprints": [
        {
          "name": "Engineering Macs",
          "description": "Managed engineering endpoints",
          "type": "classic",
          "color": "aqua-500"
        }
      ],
      "users": [
        {
          "name": "Ada Lovelace",
          "email": "ada@example.test",
          "department": "Engineering",
          "job_title": "Staff Engineer"
        }
      ],
      "tags": [
        {
          "name": "production"
        }
      ],
      "devices": [
        {
          "device_name": "Ada's MacBook Pro",
          "serial_number": "TWIN00000001",
          "model": "MacBook Pro",
          "platform": "Mac",
          "os_version": "15.6",
          "blueprint": "Engineering Macs",
          "user": "ada@example.test",
          "tags": [
            "production"
          ],
          "asset_tag": "ENG-001",
          "apps": [
            {
              "app_name": "Google Chrome",
              "bundle_id": "com.google.Chrome",
              "version": "140.0"
            }
          ]
        }
      ],
      "custom_profiles": [
        {
          "name": "Security Baseline",
          "profile": "<?xml version=\"1.0\"?><plist version=\"1.0\"><dict/></plist>",
          "active": true,
          "runs_on_mac": true
        }
      ],
      "custom_scripts": [
        {
          "name": "Inventory Check",
          "script": "#!/bin/zsh\\nexit 0",
          "execution_frequency": "every_day",
          "active": true,
          "restart": false
        }
      ],
      "custom_apps": [
        {
          "name": "Internal Tools",
          "install_type": "package",
          "install_enforcement": "install_once",
          "active": true
        }
      ],
      "vulnerabilities": [
        {
          "cve_id": "CVE-2026-0001",
          "severity": "high",
          "affected_device": "Ada's MacBook Pro"
        }
      ]
    }
  }
}
```

## Parameters

The following fields belong directly inside `seed_config.kandji`. Required nested fields are marked in their tables. Provider-native objects can contain service-specific fields beyond the representative record shapes below.

| Parameter | Type | Description |
| - | - | - |
| `blueprints` | `object[]` | Blueprints fixtures in provider-native format. |
| `users` | `object[]` | Users fixtures in provider-native format. |
| `tags` | `object[]` | Tags fixtures in provider-native format. |
| `devices` | `object[]` | Devices fixtures in provider-native format. |
| `custom_profiles` | `object[]` | Custom profiles fixtures in provider-native format. |
| `custom_scripts` | `object[]` | Custom scripts fixtures in provider-native format. |
| `custom_apps` | `object[]` | Custom apps fixtures in provider-native format. |
| `vulnerabilities` | `object[]` | Vulnerabilities fixtures in provider-native format. |
| `self_service_categories` | `object[]` | Self service categories fixtures in provider-native format. |
| `library_items` | `object[]` | Library items fixtures in provider-native format. |
| `ipa_apps` | `object[]` | Ipa apps fixtures in provider-native format. |

## Resource fields

These tables describe the record shapes used by the example. Keep native field names and casing. Map keys such as property names, IDs, and metadata keys are supplied by your fixture.

### `blueprints[]`

| Parameter | Type | Description |
| - | - | - |
| `name` | `string` | Human-readable name. |
| `description` | `string` | Description. |
| `type` | `string` | Type. |
| `color` | `string` | Color. |

### `users[]`

| Parameter | Type | Description |
| - | - | - |
| `name` | `string` | Human-readable name. |
| `email` | `string` | Main account email address. |
| `department` | `string` | Department. |
| `job_title` | `string` | Job title. |

### `tags[]`

| Parameter | Type | Description |
| - | - | - |
| `name` | `string` | Human-readable name. |

### `devices[]`

| Parameter | Type | Description |
| - | - | - |
| `device_name` | `string` | Device name. |
| `serial_number` | `string` | Serial number. |
| `model` | `string` | Model. |
| `platform` | `string` | Platform. |
| `os_version` | `string` | Os version. |
| `blueprint` | `string` | Blueprint. |
| `user` | `string` | User. |
| `tags` | `string[]` | Tags fixtures in provider-native format. |
| `asset_tag` | `string` | Asset tag. |
| `apps` | `object[]` | Apps fixtures in provider-native format. |

### `devices[].apps[]`

| Parameter | Type | Description |
| - | - | - |
| `app_name` | `string` | App name. |
| `bundle_id` | `string` | Bundle id. |
| `version` | `string` | Version. |

### `custom_profiles[]`

| Parameter | Type | Description |
| - | - | - |
| `name` | `string` | Human-readable name. |
| `profile` | `string` | Owner identity and display profile. |
| `active` | `boolean` | Enable or set active behavior. |
| `runs_on_mac` | `boolean` | Enable or set runs on mac behavior. |

### `custom_scripts[]`

| Parameter | Type | Description |
| - | - | - |
| `name` | `string` | Human-readable name. |
| `script` | `string` | Script. |
| `execution_frequency` | `string` | Execution frequency. |
| `active` | `boolean` | Enable or set active behavior. |
| `restart` | `boolean` | Enable or set restart behavior. |

### `custom_apps[]`

| Parameter | Type | Description |
| - | - | - |
| `name` | `string` | Human-readable name. |
| `install_type` | `string` | Install type. |
| `install_enforcement` | `string` | Install enforcement. |
| `active` | `boolean` | Enable or set active behavior. |

### `vulnerabilities[]`

| Parameter | Type | Description |
| - | - | - |
| `cve_id` | `string` | Cve id. |
| `severity` | `string` | Severity. |
| `affected_device` | `string` | Affected device. |

See [Scenario seeding](https://docs.argalabs.com/twins/seeding.md) for saving, provisioning, and resetting fixtures.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.