Workflow Quick Start

Create a workflow, run it in the editor, create a workflow deployment, and invoke it through the public API

By the end of this guide, you'll have a workflow running in the dashboard and a public cURL snippet you can use to invoke it from your app.

Prerequisites

• A Fetch Hive workspace

• A workspace API key if you want to run the public cURL example - see API Keys

Step 1: Create a workflow

Open Workflows in the sidebar, then click Add Workflow.

Enter a Name. If your workspace uses categories, you can also choose a Category. Click Save to open the workflow editor.

Step 2: Add your first step

In the editor, click the + connector between Start and End.

This opens Search steps.... Choose AI Prompt for the quickest possible first workflow.

When the new step appears on the canvas, click it to open Step settings.

Step 3: Configure the step

Add a short instruction in Step settings so the workflow has something useful to do.

If your workflow needs input from the caller, define that input on the Start step first, then reference it inside your AI Prompt step.

Keep the first version simple. You do not need Copilot, advanced step types, or multiple branches for this quick start.

Step 4: Run the workflow in the editor

Click Run Workflow in the header.

This opens Run History. Click Start to open Start a new Workflow Run, then click Start Workflow Run.

This is a two-step flow in the UI. Run Workflow does not start the workflow immediately by itself.

Step 5: Save a named version

Click Save Version in the header.

Enter a description of what changed, then save the version. This gives you a named version you can refer back to later.

Step 6: Create a deployment

Click Deploy, then choose Create a Deployment.

Enter a Deployment key and save it. This creates the live workflow deployment you can invoke through the public API.

Step 7: Copy the public invoke snippet

Open More in the sidebar and click Get Code, or open Code Snippet from the deployment page.

Select your Deployment and Variant. The dialog shows a cURL snippet for POST /v1/workflow/invoke.

The public payload now uses deployment and variant, matching the language shown in the UI.

curl 'https://api.fetchhive.com/v1/workflow/invoke' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data-raw '{
    "deployment": "YOUR_DEPLOYMENT_NAME",
    "variant": "YOUR_VARIANT_NAME",
    "inputs": {
      "topic": "State of enterprise AI in 2026"
    }
  }' \
  --compressed

If you want to run the workflow asynchronously, the UI also supports an Async toggle in the code snippet dialog. That adds an async block with enabled and callback_url.

Next steps

• Workflows

• Workflow Steps

• Publishing and Versioning