List n8n workflows, optionally filtered by active status, name, or comma-separated tags.

Defaults to returning up to 100 workflows. n8n caps this at 250 per request; pass a higher limit (up to 250) explicitly if you need more and results seem truncated.

Get the full definition (nodes, connections, settings) of a workflow by ID.

Create a new workflow. workflow must include name, nodes, connections, and settings.

To place the workflow in a folder instead of the project root, include parentFolderId (a folder ID from list_folders) in workflow. To create it in a project other than your personal one, include projectId.

Replace an existing workflow's definition. workflow must include name, nodes, connections, and settings.

Delete a workflow by ID.

Activate a workflow by ID.

Deactivate a workflow by ID.

List workflow executions, optionally filtered by workflow ID or status (success, error, running, waiting).

Defaults to returning up to 100 executions. n8n caps this at 250 per request; pass a higher limit (up to 250) explicitly if you need more and results seem truncated.

Get details of a specific execution by ID. Set include_data=True to include input/output data.

Trigger a workflow's execution via its Webhook trigger node, if it has one.

n8n's public API has no generic "run workflow by ID" endpoint, so this only works for workflows containing a Webhook trigger node, and the workflow must be active for the webhook to respond. data, if given, is sent as the JSON request body, landing in the workflow's $json.body.

List folders within a project, optionally filtered by parent folder or name.

project_id is required — n8n's public API has no way to discover it if your license doesn't support listing projects. If you don't know it, call list_workflows and read shared[0]["projectId"] off any returned workflow.

n8n defaults to returning only 10 folders per page. Pass a higher take (or page through with skip) if a project has more folders than that — results are silently truncated to take with no other signal that more exist.

Create a folder within a project. Pass parent_folder_id to nest it inside another folder instead of the project root.

project_id is required (see list_folders for how to find it), except that n8n also accepts the literal string "personal" to mean your own personal project.