Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The Azure Logic Apps Workflow SDK (Microsoft.Azure.Workflows.Sdk) provides fluent builder APIs for constructing Logic Apps workflow definitions programmatically in C#. This SDK enables developers to define workflows using a type-safe, IntelliSense-enabled approach instead of JSON authoring.
Architecture Overview
The SDK uses a fluent builder pattern to compose workflows through method chaining:
- Entry points: WorkflowFactory for creating workflows, WorkflowActions and WorkflowTriggers for accessing operations
- Fluent chaining:
Trigger → .Then(Action1) → .Then(Action2) → ... - Dependency injection: Support via IWorkflowProvider and WorkflowProviderExtensions for workflow registration
Class Library Reference
Workflow Composition & Chaining
Types that define how workflow operations are composed into execution graphs.
| Type | Description | Link |
|---|---|---|
| IChainableNode | Fluent chaining contract providing the Then() method pattern for composing operations |
IChainableNode |
| IWorkflowOperation | Named workflow operation with identity and downstream child connections | IWorkflowOperation |
| OperationChain | Directed chain tracking start and end nodes; supports Join() for fan-in patterns |
OperationChain |
| WorkflowFactory | Factory methods for creating stateful, stateless, and agent workflow definitions | WorkflowFactory |
Action Types
Types for defining workflow actions that execute after triggers fire.
| Type | Description | Link |
|---|---|---|
| IWorkflowAction | Interface for action steps with run-after configuration | IWorkflowAction |
| IVariableWorkflowAction | Extended action interface for variable operations | IVariableWorkflowAction |
| Typed Workflow Action Interfaces | Type-safe interfaces (IBodyWorkflowAction<T>, IOutputWorkflowAction<T>) for strongly typed output |
Typed Action Interfaces |
| WorkflowActionBase | Abstract base class providing common action functionality | WorkflowActionBase |
| WorkflowBuiltInActions | Factory for built-in actions: HTTP, Compose, Response, CustomCode, NestedWorkflow, Agent | WorkflowBuiltInActions |
| WorkflowControlActions | Factory for control flow: Scope, Condition, ForEach, Until, Switch, Terminate | WorkflowControlActions |
| WorkflowVariableActions | Factory for variable operations: Initialize, Set, Increment, Decrement, Append | WorkflowVariableActions |
| WorkflowManagedActions | Extensible managed connector actions (auto-generated from connector definitions) | WorkflowManagedActions |
Trigger Types
Types for defining workflow triggers that initiate execution.
| Type | Description | Link |
|---|---|---|
| IWorkflowTrigger | Interface for the root trigger that initiates workflow execution | IWorkflowTrigger |
| Typed Workflow Trigger Interfaces | Type-safe interfaces (IOutputWorkflowTrigger<T>, IBodyWorkflowTrigger<T>) for strongly typed output |
Typed Trigger Interfaces |
| WorkflowTriggerBase | Abstract base class providing common trigger functionality | WorkflowTriggerBase |
| WorkflowBuiltInTriggers | Factory for built-in triggers: HTTP Request, Recurrence, Conversational Agent | WorkflowBuiltInTriggers |
| WorkflowManagedTriggers | Extensible managed connector triggers (auto-generated from connector definitions) | WorkflowManagedTriggers |
Entry Points & Registration
Static entry points and dependency injection helpers.
| Type | Description | Link |
|---|---|---|
| WorkflowActions | Static entry point providing access to BuiltIn and Managed action factories |
WorkflowActions |
| WorkflowTriggers | Static entry point providing access to BuiltIn and Managed trigger factories |
WorkflowTriggers |
| IWorkflowProvider | Interface for providing workflow definitions for host registration | IWorkflowProvider |
| WorkflowProviderExtensions | DI extension methods: AddWorkflowProvider<T>, AddWorkflowProviders(assembly) |
WorkflowProviderExtensions |
Runtime & Context
Types used during workflow execution.
| Type | Description | Link |
|---|---|---|
| WorkflowContext | Abstract context providing runtime access to action and trigger results | WorkflowContext |
| AgentToolContext | Interface and class providing typed parameter access for AI agent tools | AgentToolContext |
Getting Started
To use the Logic Apps Standard SDK in your application:
- Reference the SDK: Add the
Microsoft.Azure.Workflows.SdkNuGet package to your project - Implement IWorkflowProvider: Create workflow definitions by implementing the IWorkflowProvider interface
- Use WorkflowFactory: Create workflow definitions using WorkflowFactory methods for stateful, stateless, or agent workflows
- Access Actions and Triggers: Use WorkflowActions and WorkflowTriggers as entry points to available operations
- Build with Fluent Chaining: Compose workflows using the fluent API:
trigger.Then(action1).Then(action2)
The SDK supports three workflow types: Stateful (maintains state between runs), Stateless (runs without maintaining state), and Agent (AI-powered workflows with conversational capabilities).