Logic Block Tools

Overview

Logic Blocks are the atomic units of business logic in Flowon. Flowon Logic Assist supports the full lifecycle of Logic Blocks: searching, listing, reading, creating, updating, and inspecting their dependencies.

A single create_logic_block tool creates any of the five Logic Block types. The type is selected through the logicBlockType parameter:

`logicBlockType`	Purpose
`Formula`	Calculations and value derivations
`DecisionTable`	Grid-based rule evaluation
`DecisionTree`	Hierarchical branching conditions
`Validation`	Single business rule enforcement
`ValidationSet`	Grouped validation rules

`search_logic_blocks`

Searches Flowon logic blocks by name.

Parameter	Type	Required	Description
`logicBlockName`	string	✓	The name of the logic block to search for.

Returns: Matching Logic Blocks including name, title, description, and project.

Use when: You know (or the user gave you) a Logic Block name and need to resolve it to its ID before reading, updating, or inspecting it.

`list_logic_blocks`

Lists all Flowon logic blocks. Pass the optional projectId to scope the results to a single project.

Parameter	Type	Description
`projectId`	GUID	The ID of the project to filter logic blocks by. Optional.
`pageNumber`	int	The page number for pagination. If not provided, defaults to the first page.
`pagingCookie`	string	The paging cookie for pagination. This should be provided if pageNumber is provided and there are more records to retrieve.

Returns: A paginated list of Logic Blocks including name, title, description, and project.

See Pagination for details on iterating through large result sets.

`get_logic_block_details`

Gets the details for a Flowon logic block by logic block id.

Parameter	Type	Required	Description
`logicBlockId`	GUID	✓	The ID of the logic block.

Returns: Full Logic Block details including type, metadata (the FoL definition), and all configuration.

Use when: You need to read the current definition of a Logic Block before deciding whether to update it.

`create_logic_block`

Creates a new Flowon logic block and returns the logic block id. The logicBlockType parameter selects which of the five block types to create.

Parameter	Type	Required	Description
`logicBlockType`	LogicBlockType	✓	The type of the logic block to create (`Formula`, `DecisionTable`, `DecisionTree`, `Validation`, or `ValidationSet`).
`logicBlockName`	string	✓	The name of the logic block to create.
`projectId`	GUID	✓	The ID of the project to create the logic block in.
`metadata`	string	✓	The metadata for the logic block in JSON format.
`isAction`	bool		Indicates whether the logic block is an action. Defaults to false.
`title`	string		The title for the logic block. Optional.
`description`	string		The description for the logic block. Optional.

Returns: The GUID of the newly created Logic Block and its URL.

Restriction: Cannot be called on projects associated with a managed solution. See Managed Solution Protection.

`get_logic_block_preview_url`

Get a preview URL for a Flowon Logic Block. This does not persist anything - it returns a URL that renders the block definition for review before creating it.

Parameter	Type	Required	Description
`logicBlockType`	LogicBlockType	✓	The type of the logic block.
`logicBlockName`	string	✓	The name of the logic block.
`projectId`	GUID	✓	The ID of the project for the logic block.
`metadata`	string	✓	The metadata for the logic block in JSON format.
`isAction`	bool		Indicates whether the logic block is an action. Defaults to false.
`title`	string		The title for the logic block. Optional.
`description`	string		The description for the logic block. Optional.

Returns: A preview URL for the logic block.

`update_logic_block_metadata`

Updates an existing Flowon logic block.

Parameter	Type	Required	Description
`logicBlockId`	GUID	✓	The ID of the logic block to update.
`metadata`	string	✓	The updated metadata for the logic block in JSON format.

Returns: Confirmation that the update succeeded.

Restriction: Cannot be called on Logic Blocks in projects associated with a managed solution. See Managed Solution Protection.

Best practice: Always call get_logic_block_details first to read the current metadata before updating, to avoid unintentionally overwriting parts of the definition you did not intend to change.

`list_logic_block_dependencies`

Lists the dependencies for a specific Flowon logic block.

Parameter	Type	Required	Description
`logicBlockId`	GUID	✓	The ID of the logic block.

Returns: A comprehensive dependency report:

Dependency Type	Description
Logic Block Dependencies	Other Logic Blocks this block references
Logic Flow Dependencies	Logic Flows that use this block
Logic Recipe Dependencies	Logic Recipes that invoke this block
Business Process Version Dependencies	Process Orchestrator versions that reference this block
Configuration Dependencies	Configuration records this block reads
Localized Resource Dependencies	Localized strings this block uses

Use when: Before modifying a Logic Block, call this tool to understand the full impact of the change across all dependent artifacts and projects.

Overview​

search_logic_blocks​

list_logic_blocks​

get_logic_block_details​

create_logic_block​

get_logic_block_preview_url​

update_logic_block_metadata​

list_logic_block_dependencies​