Skip to content

Create a workflow, then remove it

Machine verified A machine ran this on our install and checked the result against the CLI. A test report is linked. Proven against quoxcli 0.5.0 on 2026-11-08.

Make a workflow, and tidy it away

Create a workflow that does nothing until you say so, then delete it cleanly when you no longer need it.

What you get: a new workflow that is created switched off, so nothing fires by surprise, and a clean way to delete it again. You need: a signed-in profile. About 3 minutes.

Ask for the workflow by name, and say it should not be switched on or run:

quox · talking to Quox

Create a new manual workflow named proof-delete-me with the description "proof f73dff". Do not activate or run it.

▤ AOCL │ L1 identity complete · allowed · 1ms

▤ AOCL │ L3 policy gate complete · proceed · 4ms

◐ CREATE │ create_workflow name=proof-delete-me ✔ CREATE │ create_workflow name=proof-delete-me │ Created workflow "proof-delete-me" (wf-1794125312201-uprzqs) · 1.8s

⛓ AEE │ envelope opened · ops.tool · create_workflow ok

⛓ AEE │ envelope opened · stream_success

I've created the workflow "proof-delete-me" (id wf-1794125312201-uprzqs) with the
description "proof f73dff" and a manual trigger. It isn't active and I haven't run it.

It has no steps, so running it would do nothing until steps are added.

10.0s · 1 tool · 0 approvals

A real turn on our own install (CLI 0.5.0, 8 Nov 2026), replayed at speed. Names changed. Type the same words into quox.
✔ Machine verified against the CLI on 8 Nov 2026 · test report mw7jvr

Quox created the workflow with a manual trigger and left it inactive. It also told you the workflow has no steps yet, so running it would do nothing until you add some.

When you are finished with it, ask Quox to delete it by its id:

quox · talking to Quox

Delete the workflow with id wf-1794125312201-uprzqs. It is a throwaway test workflow named proof-delete-me.

▤ AOCL │ L1 identity complete · allowed · 0ms

▤ AOCL │ L3 policy gate complete · proceed · 4ms

◐ DELETE │ workflow ✔ DELETE │ workflow │ Deleted workflow wf-1794125312201-uprzqs · 952ms

⛓ AEE │ envelope opened · ops.tool · delete_workflow ok

⛓ AEE │ envelope opened · stream_success

The workflow  wf-1794125312201-uprzqs  (proof-delete-me) is deleted.

11.9s · 1 tool · 0 approvals

A real turn on our own install (CLI 0.5.0, 8 Nov 2026), replayed at speed. Names changed. Type the same words into quox.
✔ Machine verified against the CLI on 8 Nov 2026 · test report mw7jw1

Both the create and the delete went through Quox’s governed workflow tools, and each left a witnessed evidence record.

If you name a workflow that does not exist, Quox says so instead of guessing:

quox · talking to Quox

Run the workflow called nope-50c772 for me.

▤ AOCL │ L1 identity complete · allowed · 1ms

▤ AOCL │ L3 policy gate complete · proceed · 6ms

◐ LIST │ workflows ✔ LIST │ workflows │ 0 count, 0 matched, 5 total · 1.8s

⛓ AEE │ envelope opened · ops.tool · list_workflows ok

⛓ AEE │ envelope opened · stream_success

There's no workflow called "nope-50c772" in this org. I searched by name and got no
matches, out of 5 workflows in total. Nothing was run.

The name may have a typo, or the workflow may sit in a different org. If you'd like, I
can list all 5 workflows so you can pick the right one.

16.5s · 1 tool · 0 approvals

A real turn on our own install (CLI 0.5.0, 8 Nov 2026), replayed at speed. Names changed. Type the same words into quox.
✔ Machine verified against the CLI on 8 Nov 2026 · test report mw7jv0

Quox searched by name, found no match, ran nothing, and offered to list the workflows you do have.

create
quox workflow create --name my-workflow --description "what it is for"
Commands as quox workflow --help documents them at 0.5.0.

The workflow is created inactive: its schedule or trigger is not armed. Add --steps with a JSON array of nodes to give it steps, and --activate only when you want it live. To build one from a file instead, use quox workflow apply -f <file>.

find it
quox workflow listquox workflow get my-workflow

quox workflow get takes an id or the exact name, and shows the id you need for the next step.

delete
quox workflow delete <workflowId>

Creating and deleting a workflow are writes, so each one is recorded as evidence. Creating a workflow does not run it or arm its trigger. Asking about a workflow that is not there changes nothing.

After the delete, run quox workflow list and confirm the workflow is no longer there.

A delete cannot be undone. If you need the workflow again, create it again, or keep its definition in a file and quox workflow apply -f <file>.