N8n Public API

n8n Public API

API version: 1.1.1

Auth

ApiKey X-N8N-API-KEY in header

Base URL

/api/v1

Setup

1. Set your API key in the appropriate header
2. GET /credentials -- verify access
3. POST /audit -- create first audit

Endpoints

59 endpoints across 10 groups. See references/api-spec.lap for full details.

audit

credentials

executions

tags

workflows

users

source-control

variables

data-tables

projects

Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:

• "Create a audit?" -> POST /audit
• "List all credentials?" -> GET /credentials
• "Create a credential?" -> POST /credentials
• "Partially update a credential?" -> PATCH /credentials/{id}
• "Delete a credential?" -> DELETE /credentials/{id}
• "Get schema details?" -> GET /credentials/schema/{credentialTypeName}
• "List all executions?" -> GET /executions
• "Get execution details?" -> GET /executions/{id}
• "Delete a execution?" -> DELETE /executions/{id}
• "Create a retry?" -> POST /executions/{id}/retry
• "Create a stop?" -> POST /executions/{id}/stop
• "Create a stop?" -> POST /executions/stop
• "List all tags?" -> GET /executions/{id}/tags
• "Create a tag?" -> POST /tags
• "List all tags?" -> GET /tags
• "Get tag details?" -> GET /tags/{id}
• "Delete a tag?" -> DELETE /tags/{id}
• "Update a tag?" -> PUT /tags/{id}
• "Create a workflow?" -> POST /workflows
• "List all workflows?" -> GET /workflows
• "Get workflow details?" -> GET /workflows/{id}
• "Delete a workflow?" -> DELETE /workflows/{id}
• "Update a workflow?" -> PUT /workflows/{id}
• "Get workflow details?" -> GET /workflows/{id}/{versionId}
• "Create a activate?" -> POST /workflows/{id}/activate
• "Create a deactivate?" -> POST /workflows/{id}/deactivate
• "List all tags?" -> GET /workflows/{id}/tags
• "List all users?" -> GET /users
• "Create a user?" -> POST /users
• "Get user details?" -> GET /users/{id}
• "Delete a user?" -> DELETE /users/{id}
• "Create a pull?" -> POST /source-control/pull
• "Create a variable?" -> POST /variables
• "List all variables?" -> GET /variables
• "Delete a variable?" -> DELETE /variables/{id}
• "Update a variable?" -> PUT /variables/{id}
• "List all data-tables?" -> GET /data-tables
• "Create a data-table?" -> POST /data-tables
• "Get data-table details?" -> GET /data-tables/{dataTableId}
• "Partially update a data-table?" -> PATCH /data-tables/{dataTableId}
• "Delete a data-table?" -> DELETE /data-tables/{dataTableId}
• "Search rows?" -> GET /data-tables/{dataTableId}/rows
• "Create a row?" -> POST /data-tables/{dataTableId}/rows
• "Create a upsert?" -> POST /data-tables/{dataTableId}/rows/upsert
• "Create a project?" -> POST /projects
• "List all projects?" -> GET /projects
• "Delete a project?" -> DELETE /projects/{projectId}
• "Update a project?" -> PUT /projects/{projectId}
• "List all users?" -> GET /projects/{projectId}/users
• "Create a user?" -> POST /projects/{projectId}/users
• "Delete a user?" -> DELETE /projects/{projectId}/users/{userId}
• "Partially update a user?" -> PATCH /projects/{projectId}/users/{userId}
• "How to authenticate?" -> See Auth section

Response Tips

• Check response schemas in references/api-spec.lap for field details
• List endpoints may support pagination; check for limit, offset, or cursor params
• Create/update endpoints typically return the created/updated object

References

• Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

Generated from the official API spec by LAP