Workflows

A workflow decides how requests are routed inside a workspace. Workflows are read-only over the API. Reading needs models:read.

There is no workflows:read scope. Workflow access is granted by models:read.

Workflows are authored in the console. POST and DELETE on these endpoints return 403.

List workflows

GET /api/v1/workflows?workspace_id=ws_1

string

Limit results to one workspace.

string

Match workflows whose name contains this value.

curl 'https://app.nemu.cc/api/v1/workflows?workspace_id=ws_1' \
  -H 'Authorization: Bearer <access_token>'

const workflows = await workspace.workflows.list();

{
  "data": [
    {
      "id": "wfl_1",
      "workspace_id": "ws_1",
      "name": "default",
      "description": null,
      "enabled": true,
      "is_default": true,
      "created_at": "2026-01-04T10:22:00.000Z",
      "updated_at": "2026-01-04T10:22:00.000Z"
    }
  ],
  "total": 1
}

The list omits the workflow graph. Fetch a single workflow to get it.

Get a workflow

GET /api/v1/workflows/{id}?workspace_id=ws_1

const workflow = await workspace.workflows.get(id);

{
  "data": {
    "id": "wfl_1",
    "workspace_id": "ws_1",
    "name": "default",
    "description": null,
    "enabled": true,
    "is_default": true,
    "workflow": {},
    "created_at": "2026-01-04T10:22:00.000Z",
    "updated_at": "2026-01-04T10:22:00.000Z"
  }
}

object

The workflow graph. Returned by this endpoint only.

curl 'https://app.nemu.cc/api/v1/workflows?workspace_id=ws_1' \
  -H 'Authorization: Bearer <access_token>'

const workflows = await workspace.workflows.list();

{
  "data": [
    {
      "id": "wfl_1",
      "workspace_id": "ws_1",
      "name": "default",
      "description": null,
      "enabled": true,
      "is_default": true,
      "created_at": "2026-01-04T10:22:00.000Z",
      "updated_at": "2026-01-04T10:22:00.000Z"
    }
  ],
  "total": 1
}

Get started

API reference

List workflows

Get a workflow

​List workflows

​Get a workflow

List workflows

Get a workflow