Skip to main content
n8n logo

n8n

Lets an agent manage your n8n workflow automations through the REST API v1: list and read workflows, create and update them, activate or deactivate them, browse executions, inspect credential schemas, and read tags. Works with both n8n Cloud and self-hosted instances.

What it can do

MethodWhat it does
n8n_workflows_listList workflows (filter by active state, tags, name).
n8n_workflow_getGet one workflow by ID.
n8n_workflow_createCreate a workflow (name, nodes, connections).
n8n_workflow_updateReplace a workflow (PUT) with new nodes and connections.
n8n_workflow_activateActivate a workflow.
n8n_workflow_deactivateDeactivate a workflow.
n8n_executions_listList executions (filter by workflow, status).
n8n_execution_getGet one execution (optionally with full run data).
n8n_execution_deleteDelete an execution.
n8n_credential_schemaGet the JSON schema for a credential type.
n8n_tags_listList tags.
n8n_requestGeneric passthrough to any API v1 endpoint for full API coverage.

How to get your key

n8n authenticates with an API key sent as the X-N8N-API-KEY header. You also need your instance URL - the base host of your n8n (for example https://xxx.app.n8n.cloud for Cloud, or your self-hosted URL).

  1. Open your n8n instance.
  2. Go to Settings -> n8n API (authentication docs).
  3. Create an API key and copy it.
  4. Copy your instance base URL from the browser (no trailing /api/v1 - FlyMyAI adds that).
  5. Paste both into FlyMyAI.

Fields to fill

FlyMyAI fieldWhere it comes from
N8N_API_KEYn8n -> Settings -> n8n API
N8N_BASE_URLYour instance URL, e.g. https://xxx.app.n8n.cloud

Troubleshooting

  • 401 Unauthorized - the API key is wrong or expired. Create a new one under Settings -> n8n API.
  • Connection errors / 404 on every call - the base URL is wrong. Use the instance root (e.g. https://xxx.app.n8n.cloud), not a sub-path, and do not append /api/v1.
  • The n8n API is not enabled - on self-hosted, enable the Public API in your environment settings.
  • Credentials cannot be listed - the API does not return existing credentials for security; use n8n_credential_schema to see what a credential type expects.
We love our partners - FlyMy.AI builds with the best. Thanks, n8n!