Initialise a site and its assets, and enrol them in a proposition in a single call.

This endpoint will:

1. Upsert the site and asset(s)
2. Enrol in the relevant flex proposition

The response returns the site and asset IDs you'll use in subsequent calls, and the enrolment outcome.

Onboarding is idempotent and atomic — sending the same site or asset returns the existing record with any new fields merged in; if enrolment fails, nothing is stored.

A 200 response always means the site and assets exist and the site is enrolled; enrolment.status only distinguishes a new enrolment from an existing one. Any failure returns an HTTP error with nothing persisted, so fix the cause and send the same request again.

{
  "assets": [
    {
      "asset_model": "charger-model",
      "external_id": "charger-001",
      "installation_date": "2025-06-15",
      "properties": {
        "power_kw": 7.4
      },
      "type": "charger"
    }
  ],
  "proposition": "limited_pause"
}

{
  "enrolment": {
    "site_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "enrolled"
  }
}