Sign in

v57

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-08-012143051018.3 KB
Instance Type

Create a Machine/Instance Type association

Associate a Machine to an Instance Type

Org must have an Infrastructure Provider entity that owns the Instance Type and the Machine. User must have authorization role with PROVIDER_ADMIN suffix.

The Machine's capabilities must be a superset of the Instance Type's required capabilities for the association to succeed.

post/v2/org/{org}/nico/instance/type/{instanceTypeId}/machine

Request body

machineIdsstring[] required

ID of the Machine

Example request

{
  "machineIds": [
    "fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g",
    "fm100htrh18t1lrjg2pqagkh3sfigr9m65dejvkq168ako07sc0uibpp5q0",
    "fm100ht68sf2m52idrpslcjkpdj5r3tb3j5o0bkfubhoglbq47u18nknfog"
  ]
}

Response

Created

idstring uuid

Deprecated: Use machineId when identifying a Machine/Instance Type association. This field will be removed on July 9th, 2026 0:00 UTC.

machineIdstring

ID of the associated Machine

instanceTypeIdstring uuid

ID of the associated Instance Type

createdstring date-time

Date and time the Machine Instance Type was created

updatedstring date-time

Date and time the Machine Instance Type was last updated

Example response

[
  {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "machineId": "fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g",
    "instanceTypeId": "41e36058-8403-4086-a9b8-39cb5bc9cb98",
    "created": "2019-08-24T14:15:22Z",
    "updated": "2019-08-24T14:15:22Z"
  }
]