Blocks

Inspect workflow blocks, integration blocks, and triggers available to the workspace.

The catalog reflects the workspace’s allowed integrations, revealed preview blocks, and deployed custom blocks.

These commands accept the global options.

List blocks

sim blocks list [options]

Options

OptionRequiredDescription
--search <value>NoCase-insensitive substring match against the block id, name, and description.
--category <value>NoRestrict to one toolbar category. Accepted values: blocks, tools, triggers.
--capability <value>NoRestrict to blocks that can start a workflow — the triggers category, blocks declaring triggerAllowed, and blocks with trigger-mode fields. Accepted values: trigger.
--source <value>NoRestrict to shipped blocks or to this workspace’s deployed custom blocks. Accepted values: builtin, custom.
--include-sunsetNoInclude legacy and deprecated blocks. Off by default: a sunset block keeps executing where it is already placed, but it is not offered for new authoring. Each returned entry carries sunset.replacedBy, the block to build with instead.
--no-include-sunsetNoSend --include-sunset as false.
--sort-by <value>NoField used to sort the result. Do not rely on case-insensitive ordering when sorting by name. Defaults to "id". Accepted values: id, name, category.
--sort-order <value>NoSort direction. Defaults to "asc". Accepted values: asc, desc.
--limit <n>NoMaximum items to return (0 for everything). Defaults to 0.

API request and response schemas: listBlocks.

Get block

sim blocks get <blockId>

Arguments

ArgumentRequiredDescription
blockIdYesBlock type identifier. An unversioned base type resolves to the newest visible version. The response echoes the resolved ID.

API request and response schemas: getBlock.