Make your first API call

The ZeroWidth API is plain HTTPS + JSON. Base URL:

https://api.zerowidth.ai/1.0

A call with no key

The public flow gallery is anonymous — this works right now, no setup:

curl "https://api.zerowidth.ai/1.0/flows/public?limit=3"

{
  "data": [
    { "flowUuid": "b3c1a2d4-…", "name": "Support triage", "forkCount": 12, "updatedAt": "…" }
  ],
  "nextCursor": null
}

That's the shape of every list endpoint — a data array and a nextCursor (see Pagination).

A call that does something

To run your own flow, you need a key and a flow.

1. 1
   Mint an API key

   At accounts.zerowidth.ai → Workspace → API keys, create a key with the workbench:flows:run scope. Copy the secret when shown — it's the only time you'll see it. (Authentication)

2. 2
   Get a flow's id

   Open a flow in Workbench and copy its Flow ID from the dev drawer → Quickstart (a UUID — not the id in the editor URL). Publish a version if you haven't.

3. 3
   Run it

   curl -X POST https://api.zerowidth.ai/1.0/flows/<flowUuid>/runs \
     -H "Authorization: Bearer zw_live_…" \
     -H "Content-Type: application/json" \
     -d '{"input":{"kind":"form","values":{"data":"hello"}},"source":{"kind":"published"}}'

   The response carries the flow's outputs, the run's cost, and its duration. That's your flow, live. (Run a flow)

Next