Alteryx Engine API Overview

The Alteryx Engine API allows you to call into the Alteryx Engine. This provides you with the ability to build applications that can programatically execute Alteryx Designer workflows.

To do this, link your application with the Alteryx.lib library, and then call into the engine using the methods defined in the AlteryxEngineAPI.h header. The engine checks that Alteryx is licensed whenever it receives a request to execute a workflow.

API Use

Workflows and applications can be executed one of two ways, a separate child process, and in-process. The calling convention for the two styles differs only in the name of the method, so it is easy to switch back and forth between them. Using a child process is recommended because it isolates the calling application from unexpected runtime errors. There is a small performance penalty when using a child process when messages are marshalled between the engine and the caller. The Alteryx Engine API Methods and Callbacks help pages provide a description, syntax, parameters and example:

• Alteryx Engine API Methods: A collection of methods used for workflow interactions. For example, you can change the configuration of the engine before running a workflow or query the currently installed version of Alteryx.
• Alteryx Engine API Callbacks: Callbacks allow you to define a function that the Alteryx Engine will call based on certain events.
• See Alteryx Engine API Example for an example of using Methods and Callbacks together.

Use Alteryx Engine API checklist