workflow:create

mcp

Create a blank workflow (group group-type=workflow) — optionally cloned from a template

Effect: ask; Awaits an outcome — the call returns the response below.
Caller: manage_workflows; The class of authority the caller must already hold, decided from the attested context with no round trip.
Cost: free; What one call costs, so you can budget before acting.
Reversible: yes; The effect can be undone by a later call.
Idempotent: no; Not safe to blind-retry — dedupe on the envelope idempotencyKey.
Simulatable: yes; Accepts { simulate: true } — projects an outcome and commits nothing.

Send it with your agent

One click hands your coding agent a prompt that registers the substrate, reads this contract, and makes the call. Launch opens the app; the others copy the prompt.

Claude Code

Codex

Cursor

Gemini CLI

Claude Desktop

ChatGPT

curl -X POST https://one.ie/api/ask/workflow:create \
  -H "Authorization: Bearer $ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data": { "name": "Client Onboarding" }}'

The key is never in a link. npx -y @oneie/cli login writes it to ~/.config/oneie/key on your machine.

Request

Validated before dispatch — an invalid payload is refused with the fix, never half-applied.

slug string optional
name string required
description string optional
fromTemplate string optional
simulate boolean optional

Response

What comes back from the call.

id string
workflowId string

Traffic

Every call to workflow:create, counted where it is dispatched — over HTTP or in-process alike. Aggregate only — no actor, no payload, no workspace.

Counting…

Wiring

Every place in the open source that names workflow:create, and the file that answers it. Read from the tree at build time — a receiver is reached by NAME through one door, so there is no import edge to follow and a grep is the honest shape of the question. Structure, not volume — the count is in Traffic above.

Called from

API route 5

one.ie/web/src/lib/receiver-envelope.ts:296
one.ie/web/src/lib/resolvers/campaigns.ts:89
one.ie/web/src/lib/resolvers/install.ts:95
one.ie/web/src/lib/resolvers/pages.ts:468
one.ie/web/src/pages/api/funnels/def.ts:124

Agent runtime 1

channels/src/tools/workflows.ts:89

Workflow 3

one.ie/web/src/components/workflows/WorkflowListIsland.tsx:128
one.ie/web/src/lib/factory/flow.ts:678
one.ie/web/src/pages/u/[slug]/workflows/index.astro:16

CLI 2

packages/cli/src/compiler.ts:8
packages/cli/src/push.ts:71

Tests 1

one.ie/web/src/lib/factory/workflows-derived.test.ts:20

Docs 2

one.ie/web/src/content/docs/receivers.md:244
one.ie/web/src/lib/CLAUDE.md:92

→

Answered by

workflow:create one.ie/web/src/lib/workflow-receivers.ts:1815 Dispatched through POST /api/ask/workflow:create, after the envelope validates the payload.

workflow family · 17 more

workflow:apply-diff workflow:apply-tql workflow:delete workflow:fade workflow:get workflow:list workflow:preview-step workflow:run workflow:runs workflow:settled-notify workflow:step-stats workflow:stop workflow:tql workflow:trigger workflow:update workflow:validate workflow:webhook-subscribe

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "fromTemplate": {
      "type": "string"
    },
    "simulate": {
      "type": "boolean"
    }
  },
  "required": [
    "name"
  ]
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "workflowId": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "workflowId"
  ]
}