API Reference

The primary endpoint for creating and updating workflows. Accepts both Recipe (agent-friendly) and IR (canvas/internal) formats. Deploys the workflow and optionally starts a run.

{
  "name": "Lead Notifier",
  "trigger": {
    "type": "webhook",
    "config": { "path": "/new-lead", "method": "POST" }
  },
  "steps": [
    {
      "ref": "format",
      "action": "transform",
      "config": {
        "template": { "msg": "New: {{trigger.output.body.name}}" }
      }
    },
    {
      "ref": "notify",
      "action": "slack",
      "config": { "channel": "#sales", "text": "{{format.output.msg}}" },
      "credential": "slack"
    }
  ],
  "flow": ["format", "notify"],
  "slug": "lead-notifier",
  "autoRun": true,
  "callback_url": "https://your-app.com/webhook"
}

{
  "ok": true,
  "workflowId": "uuid",
  "versionId": "uuid",
  "version": 1,
  "hash": "sha256-hash",
  "runId": "uuid",
  "monitorUrl": "https://s6s.ai/runs/uuid",
  "webhookTrigger": {
    "path": "/new-lead",
    "invokeUrl": "https://s6s.ai/api/webhooks/new-lead",
    "secret": "hex-string"
  }
}

{
  "ok": true,
  "workflowId": "uuid",
  "runId": null,
  "missing_credentials": [
    {
      "provider": "slack",
      "ref": "slack",
      "node_name": "Notify",
      "connect_url": "https://s6s.ai/credentials/connect/slack",
      "setup_instructions": "..."
    }
  ],
  "message": "Workflow saved but cannot run — missing credentials for: slack"
}

Returns all workflows with their latest version info.

{
  "workflows": [
    {
      "id": "uuid",
      "name": "Lead Notifier",
      "slug": "lead-notifier",
      "enabled": true,
      "version": 2,
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-16T08:30:00Z"
    }
  ]
}

Returns workflow details including the latest version JSON.

Update a workflow's name or enabled status.

{
  "name": "Updated Name",
  "enabled": false
}

Soft-deletes a workflow. Active runs are cancelled.

Pre-flight check. Validates structure, trigger, schedule, credentials, and node config without executing.

{
  "status": "ready",
  "summary": "All checks passed",
  "checks": [
    { "check": "structure", "status": "pass", "detail": null },
    { "check": "credentials", "status": "pass", "detail": null },
    { "check": "schedule", "status": "pass", "detail": null },
    { "check": "node_config", "status": "pass", "detail": null }
  ]
}

Manually trigger a run for a deployed workflow.

{
  "runId": "uuid",
  "workflowId": "uuid",
  "versionId": "uuid",
  "version": 1,
  "status": "running"
}

Returns a paginated list of recent runs. Supports optional query parameters.

Returns run details including summary, step summaries, and full step results.

{
  "runId": "uuid",
  "workflowId": "uuid",
  "status": "succeeded",
  "startedAt": "2026-01-15T10:30:00Z",
  "finishedAt": "2026-01-15T10:30:02Z",
  "durationMs": 2340,
  "stepCount": 3,
  "summary": "3/3 steps succeeded.",
  "stepSummaries": [
    {
      "nodeId": "uuid",
      "nodeType": "action.http",
      "status": "succeeded",
      "durationMs": 150,
      "errorCode": null
    }
  ],
  "failureReason": null,
  "errorCode": null
}

Cancels an active run. Returns the updated run status.

Retries a failed or cancelled run. Creates a new run from the same workflow version.

{
  "runId": "new-uuid",
  "workflowId": "uuid",
  "status": "running"
}

Returns all available node types with their schemas. Useful for building agent system prompts and for auto-generating workflow UIs.

Returns all learned integrations (provider, actions, auth type, setup instructions).

Returns full details for a specific integration. S6S auto-learns integration details as providers are used.

Paginated activity log of deployments, runs, errors, and other events.

Returns all credential bindings for the current user. Secrets are never exposed.

{
  "credentials": [
    {
      "bindingId": "uuid",
      "provider": "slack",
      "capability": "oauth",
      "accountLabel": "My Slack",
      "status": "ready",
      "expiresAt": null
    }
  ]
}

Triggers a webhook-triggered workflow. No authentication required — uses the webhook secret for verification. The path is defined when deploying the workflow.

curl -X POST https://s6s.ai/api/webhooks/new-lead \
  -H "Content-Type: application/json" \
  -d '{ "name": "Jane Doe", "email": "[email protected]" }'

Crawl a website and auto-extract brand info (name, products, keywords, competitors). Accepts optional targetLocations for location-aware discovery.

List or create brands to track. POST accepts name, domain, keywords, competitors, engines (array of perplexity/chatgpt/gemini/claude/grok).

Single brand CRUD operations.

Run an AI visibility check across selected engines. Uses multi-run frequency scoring (3-5 parallel runs per keyword per engine).

Score time-series (up to 365 days). Returns daily aggregates with overall, per-engine, and component breakdowns (frequency, sentiment, position, cross-engine, coverage, consistency).

Deterministic site audit: robots.txt, schema markup, Wikipedia/Reddit presence. Runs in 3-5 seconds, costs zero credits.

Returns prioritized actionable recommendations (15+ types) and accuracy/hallucination report.

POST deploys fix workflows (schema gen, FAQ, content recs, YouTube scripts, X threads, Reddit monitor). GET returns persisted fix results.

Generates print-ready HTML report with HMAC-signed share links (valid 30 days, no login required).

Aggregated dashboard: 7-day score delta, average score, top/lowest brand, total counts.

No authentication required. Free public site audit for any domain.

Permanently deletes user account and all associated data (workflows, runs, credentials, visibility brands, billing).

GDPR data export. Returns all user data including workflows, runs, credential metadata, billing transactions, and all visibility tables.

Health check endpoint. No authentication required. Returns 200 when healthy, 503 when the database is unreachable.

{
  "status": "ok",
  "timestamp": "2026-01-15T10:30:00Z",
  "version": "0.1.0"
}