Skip to main content

Use Case

Run batch data enrichment and automated processing pipelines. Workflows are ideal for processing many records through multi-step pipelines (e.g., validate emails, enrich companies, export to CSV) without manual intervention.

Core Concepts

The Workflows API models pipelines as directed acyclic graphs (DAGs):
TermDescription
WorkflowA reusable pipeline definition containing blocks and edges
BlockA processing step (e.g., webhook input, enrichment, filtering, export)
EdgeA connection between blocks that defines data flow
RunAn execution instance of a workflow
Job IDA unique identifier for tracking a workflow run

Execution Flow

  1. List workflows — Get available workflows in your organization
  2. Run workflow — Execute with input data; receive a job_id
  3. Poll live status — Monitor progress until completed, failed, or cancelled
  4. Download results — Get signed URLs for result files (CSV)
Workflows starting with a read_csv block cannot be triggered via API. Use workflows that start with a webhook block for API-triggered runs.

Quick Start

Don’t want to write code? Use Sixtyfour’s Workflow Builder to create and manage your own workflows.
# 1. List available workflows
curl -X GET "https://api.sixtyfour.ai/workflows" \
  -H "x-api-key: YOUR_API_KEY"

# 2. Run a workflow with data
curl -X POST "https://api.sixtyfour.ai/workflows/run?workflow_id=WORKFLOW_ID" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_payload": [
      {"company_name": "Acme Corp", "website": "acme.com"}
    ]
  }'

# 3. Check status (use job_id from step 2)
curl -X GET "https://api.sixtyfour.ai/workflows/runs/JOB_ID/live_status" \
  -H "x-api-key: YOUR_API_KEY"

# 4. Download results
curl -X GET "https://api.sixtyfour.ai/workflows/runs/JOB_ID/results/download-links" \
  -H "x-api-key: YOUR_API_KEY"

Next Steps