Create a unit
POST/nevisidm/api/core/v1/:clientExtId/units
Since: 2.73.0
Required permission(s): AccessControl.UnitCreate,AccessControl.UnitCreateTopUnit
Creates a new unit for the client with the given external ID.
If a parent unit external ID is provided, the new unit becomes a child of that parent. If no parent unit is provided, the unit becomes a root unit, which requires the AccessControl.UnitCreateTopUnit permission.
If no external ID is provided, one is generated automatically. The unit name must be unique under the same parent and conform to the configured identifier naming policy.
Request
Responses
- 201
- 403
- 404
- 422
Unit created successfully
Response Headers
Location
URL of the created resource
Insufficient permissions
Referenced resource not found
Invalid unit data