Run Agent
Initiate the execution of a specific Agent by its name. You can specify input variables, metadata, and choose which version of the Agent to run.
Please note that this feature was previously called “Workflows” and is now called “Agents”. Some references to “Workflows” remain in our SDK and will be updated before the feature exits beta.
HTTP Request
POST /workflows/{workflow_name}/run
Path Parameters
- workflow_name (string, required): The name of the Agent you wish to execute.
Request Body
The request body expects a JSON object with the following structure:
Schema
Headers
Your API key for authentication.
Path Parameters
The name of the workflow to execute.
Body
Parameters to run a workflow.
Specify a workflow label name to run a specific labeled version.
Specify a workflow version number to run a specific version.
A dictionary of metadata key-value pairs.
A dictionary of input variables required by the workflow.
If set to true
, all outputs from the workflow execution will be returned.
Response
Response after initiating a workflow execution.
Indicates if the request was successful.
A message describing the result.
The ID of the created workflow execution.
Any warnings about missing input variables.
Was this page helpful?