Unit

Create multiple units

Use this call to create multiple units, following a naming rule.<br>You must have at least one of these scopes: 'units.create, setup.manage'.

post/inventory/v0-nsfw/units/bulk

Request

Base URL
https://api.apaleo.com (the document declares no server; this is the origin it was published from)
URL
https://api.apaleo.com/inventory/v0-nsfw/units/bulk
Auth
OAuth 2
Implicit: https://identity.apaleo.com/connect/authorize
Scopes: units.create, setup.manage, admin

Headers

Idempotency-Keystring

Unique key for safely retrying requests without accidentally performing the same operation twice. We'll always send back the same response for requests made with the same key, and keys can't be reused with different request parameters. Keys expire after 24 hours.

Request body

Example request

{
  "units": [
    {
      "propertyId": "MUC",
      "name": "A.201",
      "description": {
        "en": "Single room",
        "de": "Einzelzimmer"
      },
      "unitGroupId": "MUC-SGL",
      "maxPersons": 1,
      "condition": "Clean",
      "attributes": [],
      "connectedUnits": []
    },
    {
      "propertyId": "MUC",
      "name": "A.103",
      "description": {
        "en": "Double room",
        "de": "Doppelzimmer"
      },
      "unitGroupId": "MUC-DBL",
      "maxPersons": 2,
      "condition": "Clean",
      "attributes": [],
      "connectedUnits": []
    },
    {
      "propertyId": "MUC",
      "name": "S.102",
      "description": {
        "en": "Suite room",
        "de": "Suite Zimmer"
      },
      "unitGroupId": "MUC-SUI",
      "maxPersons": 3,
      "condition": "Clean",
      "attributes": [],
      "connectedUnits": [
        {
          "unitId": "MUC-MTA"
        },
        {
          "unitId": "MUC-JQI"
        }
      ]
    }
  ]
}

Response

Success.

idsstring[] required

The unit ids

Example response

{
  "ids": [
    "MUC-CFP",
    "MUC-XTA",
    "MUC-CPZ"
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.