BlockUpdate
- idType: stringrequired
- brickType:Properties: 4
What a brick holds, in the vocabulary of the block-level operations: the blocks it holds, named by the names
GET /blockslists, the outputs it declares and the connections between them. It is what a block that runs a brick (nests_a_diagram) brings, and it is refused on any other block withblock_not_a_brick. Without it, such a block answersbrick_missing.The brick starts at its block placed under the id
brick_start, so name the first block that. A connection inside it ending atoutputs.$Nleaves the brick by the output$Nit declares; the connections leaving the brick block name that same$Nas theirtype, ordefault. Every refusal about something inside names it by its trail,B0->n0.It is written whole: on an update it replaces the blocks, connections and notes the brick held, and an output it no longer declares that a connection still leaves the block by is refused with
connection_output_removed, unless the same change set removes that connection. A block inside it may not run a brick of its own (brick_nesting_unsupported), and the brick reads back fromGET /bots/{bot_id}/draftin the builder's shape, as aBrick. - leftType: integer
How far across the builder's canvas to move the block. Omitted, it stays where it is.
- nameType: string | null
Send
nullto remove the label. On a block that runs a brick, a name renames the brick too, which is the name the builder shows on the block. - paramsType: objectProperties: 1
Replaces the block's params as a whole.
- topType: integer
How far down the builder's canvas to move the block. Omitted, it stays where it is.