Skip to main content

Create building block

POST 

/api/meshobjects/meshbuildingblocks

Create a new meshBuildingBlock with specified inputs, parent relationships, and target configuration. Authorization: API keys may only create building blocks targeting their own workspace's tenants. This applies both to workspace-scoped keys (BUILDINGBLOCK_SAVE) and to keys with 'Manage Building Blocks for owned definition' (MANAGED_BUILDINGBLOCK_SAVE): a MANAGED key may create blocks only for definitions its own workspace owns (a definition owned by a different workspace is rejected with 403), and it cannot create blocks in another workspace. A MANAGED key's cross-workspace ability to set PLATFORM_OPERATOR_MANUAL_INPUT values on an existing block is available only via PUT. Setting operator inputs while creating a block requires admin permissions (ADM_BUILDINGBLOCK_SAVE).

Authentication: This endpoint supports API Key authentication.

Request

Responses

201