naftiko: 1.0.0-alpha2 info: label: n8n Public API description: The n8n public REST API provides programmatic access to n8n instance resources including workflows, executions, credentials, users, tags, variables, projects, source control, audit, data tables, community packages, folders, and insights. tags: - N8n - API created: '2026-05-06' modified: '2026-05-06' capability: consumes: - type: http namespace: n8n baseUri: https://app.n8n.cloud/api/v1 description: n8n Public API HTTP API. authentication: type: apikey in: header name: X-N8N-API-KEY value: '{{N8N_TOKEN}}' resources: - name: audit path: /audit operations: - name: generateaudit method: POST description: Generate an audit outputRawFormat: json outputParameters: - name: result type: object value: $. - name: credentials path: /credentials operations: - name: createcredential method: POST description: Create a credential outputRawFormat: json outputParameters: - name: result type: object value: $. - name: credentials-id path: /credentials/{id} operations: - name: deletecredential method: DELETE description: Delete credential by ID inputParameters: - name: id in: path type: string required: true description: The credential ID. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: credentials-id-test path: /credentials/{id}/test operations: - name: testcredential method: POST description: Test a credential inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: credentials-schema-credentialtypename path: /credentials/schema/{credentialTypeName} operations: - name: getcredentialschema method: GET description: Show credential data schema inputParameters: - name: credentialTypeName in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: credentials-id-transfer path: /credentials/{id}/transfer operations: - name: transfercredential method: PUT description: Transfer a credential to another project inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: executions path: /executions operations: - name: getexecutions method: GET description: Retrieve all executions inputParameters: - name: includeData in: query type: boolean - name: status in: query type: string - name: workflowId in: query type: string - name: projectId in: query type: string - name: limit in: query type: number - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: executions-id path: /executions/{id} operations: - name: getexecution method: GET description: Retrieve an execution inputParameters: - name: id in: path type: number required: true - name: includeData in: query type: boolean outputRawFormat: json outputParameters: - name: result type: object value: $. - name: deleteexecution method: DELETE description: Delete an execution inputParameters: - name: id in: path type: number required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: executions-id-retry path: /executions/{id}/retry operations: - name: retryexecution method: POST description: Retry an execution inputParameters: - name: id in: path type: number required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: executions-id-stop path: /executions/{id}/stop operations: - name: stopexecution method: POST description: Stop an execution inputParameters: - name: id in: path type: number required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: executions-stop path: /executions/stop operations: - name: stopexecutions method: POST description: Stop multiple executions outputRawFormat: json outputParameters: - name: result type: object value: $. - name: executions-id-tags path: /executions/{id}/tags operations: - name: updateexecutiontags method: PUT description: Update tags on an execution inputParameters: - name: id in: path type: number required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: tags path: /tags operations: - name: createtag method: POST description: Create a tag outputRawFormat: json outputParameters: - name: result type: object value: $. - name: gettags method: GET description: Retrieve all tags inputParameters: - name: limit in: query type: number - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: tags-id path: /tags/{id} operations: - name: gettag method: GET description: Retrieves a tag inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: deletetag method: DELETE description: Delete a tag inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: updatetag method: PUT description: Update a tag inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workflows path: /workflows operations: - name: createworkflow method: POST description: Create a workflow outputRawFormat: json outputParameters: - name: result type: object value: $. - name: getworkflows method: GET description: Retrieve all workflows inputParameters: - name: active in: query type: boolean - name: tags in: query type: string - name: name in: query type: string - name: projectId in: query type: string - name: excludePinnedData in: query type: boolean - name: limit in: query type: number - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workflows-id path: /workflows/{id} operations: - name: getworkflow method: GET description: Retrieves a workflow inputParameters: - name: id in: path type: string required: true - name: excludePinnedData in: query type: boolean outputRawFormat: json outputParameters: - name: result type: object value: $. - name: deleteworkflow method: DELETE description: Delete a workflow inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: updateworkflow method: PUT description: Update a workflow inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workflows-id-versionid path: /workflows/{id}/{versionId} operations: - name: getworkflowversion method: GET description: Retrieves a specific version of a workflow inputParameters: - name: id in: path type: string required: true - name: versionId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workflows-id-activate path: /workflows/{id}/activate operations: - name: activateworkflow method: POST description: Activate a workflow inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workflows-id-deactivate path: /workflows/{id}/deactivate operations: - name: deactivateworkflow method: POST description: Deactivate a workflow inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workflows-id-archive path: /workflows/{id}/archive operations: - name: archiveworkflow method: POST description: Archive a workflow inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workflows-id-unarchive path: /workflows/{id}/unarchive operations: - name: unarchiveworkflow method: POST description: Unarchive a workflow inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workflows-id-transfer path: /workflows/{id}/transfer operations: - name: transferworkflow method: PUT description: Transfer a workflow to another project inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: workflows-id-tags path: /workflows/{id}/tags operations: - name: getworkflowtags method: GET description: Get workflow tags inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: updateworkflowtags method: PUT description: Update tags of a workflow inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: users path: /users operations: - name: getusers method: GET description: Retrieve all users inputParameters: - name: limit in: query type: number - name: cursor in: query type: string - name: includeRole in: query type: boolean - name: projectId in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: createusers method: POST description: Create multiple users outputRawFormat: json outputParameters: - name: result type: object value: $. - name: users-id path: /users/{id} operations: - name: getuser method: GET description: Get user by ID/Email inputParameters: - name: id in: path type: string required: true - name: includeRole in: query type: boolean outputRawFormat: json outputParameters: - name: result type: object value: $. - name: deleteuser method: DELETE description: Delete a user inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: users-id-role path: /users/{id}/role operations: - name: changeuserrole method: PATCH description: Change a user's global role inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: source-control-pull path: /source-control/pull operations: - name: sourcecontrolpull method: POST description: Pull changes from the remote repository outputRawFormat: json outputParameters: - name: result type: object value: $. - name: variables path: /variables operations: - name: createvariable method: POST description: Create a variable outputRawFormat: json outputParameters: - name: result type: object value: $. - name: getvariables method: GET description: Retrieve variables inputParameters: - name: limit in: query type: number - name: cursor in: query type: string outputRawFormat: json outputParameters: - name: result type: object value: $. - name: variables-id path: /variables/{id} operations: - name: deletevariable method: DELETE description: Delete a variable inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: updatevariable method: PUT description: Update a variable inputParameters: - name: id in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: data-tables path: /data-tables operations: - name: listdatatables method: GET description: List all data tables outputRawFormat: json outputParameters: - name: result type: object value: $. - name: createdatatable method: POST description: Create a data table outputRawFormat: json outputParameters: - name: result type: object value: $. - name: data-tables-datatableid path: /data-tables/{dataTableId} operations: - name: getdatatable method: GET description: Get a data table inputParameters: - name: dataTableId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: deletedatatable method: DELETE description: Delete a data table inputParameters: - name: dataTableId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: updatedatatable method: PATCH description: Update a data table inputParameters: - name: dataTableId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: data-tables-datatableid-rows path: /data-tables/{dataTableId}/rows operations: - name: listdatatablerows method: GET description: List rows in a data table inputParameters: - name: dataTableId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: insertdatatablerows method: POST description: Insert rows into a data table inputParameters: - name: dataTableId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: data-tables-datatableid-rows-update path: /data-tables/{dataTableId}/rows/update operations: - name: updatedatatablerows method: POST description: Update rows in a data table inputParameters: - name: dataTableId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: data-tables-datatableid-rows-upsert path: /data-tables/{dataTableId}/rows/upsert operations: - name: upsertdatatablerows method: POST description: Upsert rows in a data table inputParameters: - name: dataTableId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: data-tables-datatableid-rows-delete path: /data-tables/{dataTableId}/rows/delete operations: - name: deletedatatablerows method: POST description: Delete rows in a data table inputParameters: - name: dataTableId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: data-tables-datatableid-columns path: /data-tables/{dataTableId}/columns operations: - name: listdatatablecolumns method: GET description: List columns in a data table inputParameters: - name: dataTableId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: adddatatablecolumn method: POST description: Add a column to a data table inputParameters: - name: dataTableId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: data-tables-datatableid-columns-columnid path: /data-tables/{dataTableId}/columns/{columnId} operations: - name: deletedatatablecolumn method: DELETE description: Delete a column from a data table inputParameters: - name: dataTableId in: path type: string required: true - name: columnId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: projects path: /projects operations: - name: createproject method: POST description: Create a project outputRawFormat: json outputParameters: - name: result type: object value: $. - name: getprojects method: GET description: Retrieve projects outputRawFormat: json outputParameters: - name: result type: object value: $. - name: projects-projectid path: /projects/{projectId} operations: - name: deleteproject method: DELETE description: Delete a project inputParameters: - name: projectId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: updateproject method: PUT description: Update a project inputParameters: - name: projectId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: projects-projectid-users path: /projects/{projectId}/users operations: - name: getprojectusers method: GET description: Get project users inputParameters: - name: projectId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. - name: addprojectusers method: POST description: Add users to a project inputParameters: - name: projectId in: path type: string required: true outputRawFormat: json outputParameters: - name: result type: object value: $. exposes: - type: rest port: 8080 namespace: n8n-rest description: REST adapter for n8n Public API. resources: - path: /audit name: generateaudit operations: - method: POST name: generateaudit description: Generate an audit call: n8n.generateaudit outputParameters: - type: object mapping: $. - path: /credentials name: createcredential operations: - method: POST name: createcredential description: Create a credential call: n8n.createcredential outputParameters: - type: object mapping: $. - path: /credentials/{id} name: deletecredential operations: - method: DELETE name: deletecredential description: Delete credential by ID call: n8n.deletecredential with: id: rest.id outputParameters: - type: object mapping: $. - path: /credentials/{id}/test name: testcredential operations: - method: POST name: testcredential description: Test a credential call: n8n.testcredential with: id: rest.id outputParameters: - type: object mapping: $. - path: /credentials/schema/{credentialTypeName} name: getcredentialschema operations: - method: GET name: getcredentialschema description: Show credential data schema call: n8n.getcredentialschema with: credentialTypeName: rest.credentialTypeName outputParameters: - type: object mapping: $. - path: /credentials/{id}/transfer name: transfercredential operations: - method: PUT name: transfercredential description: Transfer a credential to another project call: n8n.transfercredential with: id: rest.id outputParameters: - type: object mapping: $. - path: /executions name: getexecutions operations: - method: GET name: getexecutions description: Retrieve all executions call: n8n.getexecutions outputParameters: - type: object mapping: $. - path: /executions/{id} name: getexecution operations: - method: GET name: getexecution description: Retrieve an execution call: n8n.getexecution with: id: rest.id outputParameters: - type: object mapping: $. - path: /executions/{id} name: deleteexecution operations: - method: DELETE name: deleteexecution description: Delete an execution call: n8n.deleteexecution with: id: rest.id outputParameters: - type: object mapping: $. - path: /executions/{id}/retry name: retryexecution operations: - method: POST name: retryexecution description: Retry an execution call: n8n.retryexecution with: id: rest.id outputParameters: - type: object mapping: $. - path: /executions/{id}/stop name: stopexecution operations: - method: POST name: stopexecution description: Stop an execution call: n8n.stopexecution with: id: rest.id outputParameters: - type: object mapping: $. - path: /executions/stop name: stopexecutions operations: - method: POST name: stopexecutions description: Stop multiple executions call: n8n.stopexecutions outputParameters: - type: object mapping: $. - path: /executions/{id}/tags name: updateexecutiontags operations: - method: PUT name: updateexecutiontags description: Update tags on an execution call: n8n.updateexecutiontags with: id: rest.id outputParameters: - type: object mapping: $. - path: /tags name: createtag operations: - method: POST name: createtag description: Create a tag call: n8n.createtag outputParameters: - type: object mapping: $. - path: /tags name: gettags operations: - method: GET name: gettags description: Retrieve all tags call: n8n.gettags outputParameters: - type: object mapping: $. - path: /tags/{id} name: gettag operations: - method: GET name: gettag description: Retrieves a tag call: n8n.gettag with: id: rest.id outputParameters: - type: object mapping: $. - path: /tags/{id} name: deletetag operations: - method: DELETE name: deletetag description: Delete a tag call: n8n.deletetag with: id: rest.id outputParameters: - type: object mapping: $. - path: /tags/{id} name: updatetag operations: - method: PUT name: updatetag description: Update a tag call: n8n.updatetag with: id: rest.id outputParameters: - type: object mapping: $. - path: /workflows name: createworkflow operations: - method: POST name: createworkflow description: Create a workflow call: n8n.createworkflow outputParameters: - type: object mapping: $. - path: /workflows name: getworkflows operations: - method: GET name: getworkflows description: Retrieve all workflows call: n8n.getworkflows outputParameters: - type: object mapping: $. - path: /workflows/{id} name: getworkflow operations: - method: GET name: getworkflow description: Retrieves a workflow call: n8n.getworkflow with: id: rest.id outputParameters: - type: object mapping: $. - path: /workflows/{id} name: deleteworkflow operations: - method: DELETE name: deleteworkflow description: Delete a workflow call: n8n.deleteworkflow with: id: rest.id outputParameters: - type: object mapping: $. - path: /workflows/{id} name: updateworkflow operations: - method: PUT name: updateworkflow description: Update a workflow call: n8n.updateworkflow with: id: rest.id outputParameters: - type: object mapping: $. - path: /workflows/{id}/{versionId} name: getworkflowversion operations: - method: GET name: getworkflowversion description: Retrieves a specific version of a workflow call: n8n.getworkflowversion with: id: rest.id versionId: rest.versionId outputParameters: - type: object mapping: $. - path: /workflows/{id}/activate name: activateworkflow operations: - method: POST name: activateworkflow description: Activate a workflow call: n8n.activateworkflow with: id: rest.id outputParameters: - type: object mapping: $. - path: /workflows/{id}/deactivate name: deactivateworkflow operations: - method: POST name: deactivateworkflow description: Deactivate a workflow call: n8n.deactivateworkflow with: id: rest.id outputParameters: - type: object mapping: $. - path: /workflows/{id}/archive name: archiveworkflow operations: - method: POST name: archiveworkflow description: Archive a workflow call: n8n.archiveworkflow with: id: rest.id outputParameters: - type: object mapping: $. - path: /workflows/{id}/unarchive name: unarchiveworkflow operations: - method: POST name: unarchiveworkflow description: Unarchive a workflow call: n8n.unarchiveworkflow with: id: rest.id outputParameters: - type: object mapping: $. - path: /workflows/{id}/transfer name: transferworkflow operations: - method: PUT name: transferworkflow description: Transfer a workflow to another project call: n8n.transferworkflow with: id: rest.id outputParameters: - type: object mapping: $. - path: /workflows/{id}/tags name: getworkflowtags operations: - method: GET name: getworkflowtags description: Get workflow tags call: n8n.getworkflowtags with: id: rest.id outputParameters: - type: object mapping: $. - path: /workflows/{id}/tags name: updateworkflowtags operations: - method: PUT name: updateworkflowtags description: Update tags of a workflow call: n8n.updateworkflowtags with: id: rest.id outputParameters: - type: object mapping: $. - path: /users name: getusers operations: - method: GET name: getusers description: Retrieve all users call: n8n.getusers outputParameters: - type: object mapping: $. - path: /users name: createusers operations: - method: POST name: createusers description: Create multiple users call: n8n.createusers outputParameters: - type: object mapping: $. - path: /users/{id} name: getuser operations: - method: GET name: getuser description: Get user by ID/Email call: n8n.getuser with: id: rest.id outputParameters: - type: object mapping: $. - path: /users/{id} name: deleteuser operations: - method: DELETE name: deleteuser description: Delete a user call: n8n.deleteuser with: id: rest.id outputParameters: - type: object mapping: $. - path: /users/{id}/role name: changeuserrole operations: - method: PATCH name: changeuserrole description: Change a user's global role call: n8n.changeuserrole with: id: rest.id outputParameters: - type: object mapping: $. - path: /source-control/pull name: sourcecontrolpull operations: - method: POST name: sourcecontrolpull description: Pull changes from the remote repository call: n8n.sourcecontrolpull outputParameters: - type: object mapping: $. - path: /variables name: createvariable operations: - method: POST name: createvariable description: Create a variable call: n8n.createvariable outputParameters: - type: object mapping: $. - path: /variables name: getvariables operations: - method: GET name: getvariables description: Retrieve variables call: n8n.getvariables outputParameters: - type: object mapping: $. - path: /variables/{id} name: deletevariable operations: - method: DELETE name: deletevariable description: Delete a variable call: n8n.deletevariable with: id: rest.id outputParameters: - type: object mapping: $. - path: /variables/{id} name: updatevariable operations: - method: PUT name: updatevariable description: Update a variable call: n8n.updatevariable with: id: rest.id outputParameters: - type: object mapping: $. - path: /data-tables name: listdatatables operations: - method: GET name: listdatatables description: List all data tables call: n8n.listdatatables outputParameters: - type: object mapping: $. - path: /data-tables name: createdatatable operations: - method: POST name: createdatatable description: Create a data table call: n8n.createdatatable outputParameters: - type: object mapping: $. - path: /data-tables/{dataTableId} name: getdatatable operations: - method: GET name: getdatatable description: Get a data table call: n8n.getdatatable with: dataTableId: rest.dataTableId outputParameters: - type: object mapping: $. - path: /data-tables/{dataTableId} name: deletedatatable operations: - method: DELETE name: deletedatatable description: Delete a data table call: n8n.deletedatatable with: dataTableId: rest.dataTableId outputParameters: - type: object mapping: $. - path: /data-tables/{dataTableId} name: updatedatatable operations: - method: PATCH name: updatedatatable description: Update a data table call: n8n.updatedatatable with: dataTableId: rest.dataTableId outputParameters: - type: object mapping: $. - path: /data-tables/{dataTableId}/rows name: listdatatablerows operations: - method: GET name: listdatatablerows description: List rows in a data table call: n8n.listdatatablerows with: dataTableId: rest.dataTableId outputParameters: - type: object mapping: $. - path: /data-tables/{dataTableId}/rows name: insertdatatablerows operations: - method: POST name: insertdatatablerows description: Insert rows into a data table call: n8n.insertdatatablerows with: dataTableId: rest.dataTableId outputParameters: - type: object mapping: $. - path: /data-tables/{dataTableId}/rows/update name: updatedatatablerows operations: - method: POST name: updatedatatablerows description: Update rows in a data table call: n8n.updatedatatablerows with: dataTableId: rest.dataTableId outputParameters: - type: object mapping: $. - path: /data-tables/{dataTableId}/rows/upsert name: upsertdatatablerows operations: - method: POST name: upsertdatatablerows description: Upsert rows in a data table call: n8n.upsertdatatablerows with: dataTableId: rest.dataTableId outputParameters: - type: object mapping: $. - path: /data-tables/{dataTableId}/rows/delete name: deletedatatablerows operations: - method: POST name: deletedatatablerows description: Delete rows in a data table call: n8n.deletedatatablerows with: dataTableId: rest.dataTableId outputParameters: - type: object mapping: $. - path: /data-tables/{dataTableId}/columns name: listdatatablecolumns operations: - method: GET name: listdatatablecolumns description: List columns in a data table call: n8n.listdatatablecolumns with: dataTableId: rest.dataTableId outputParameters: - type: object mapping: $. - path: /data-tables/{dataTableId}/columns name: adddatatablecolumn operations: - method: POST name: adddatatablecolumn description: Add a column to a data table call: n8n.adddatatablecolumn with: dataTableId: rest.dataTableId outputParameters: - type: object mapping: $. - path: /data-tables/{dataTableId}/columns/{columnId} name: deletedatatablecolumn operations: - method: DELETE name: deletedatatablecolumn description: Delete a column from a data table call: n8n.deletedatatablecolumn with: dataTableId: rest.dataTableId columnId: rest.columnId outputParameters: - type: object mapping: $. - path: /projects name: createproject operations: - method: POST name: createproject description: Create a project call: n8n.createproject outputParameters: - type: object mapping: $. - path: /projects name: getprojects operations: - method: GET name: getprojects description: Retrieve projects call: n8n.getprojects outputParameters: - type: object mapping: $. - path: /projects/{projectId} name: deleteproject operations: - method: DELETE name: deleteproject description: Delete a project call: n8n.deleteproject with: projectId: rest.projectId outputParameters: - type: object mapping: $. - path: /projects/{projectId} name: updateproject operations: - method: PUT name: updateproject description: Update a project call: n8n.updateproject with: projectId: rest.projectId outputParameters: - type: object mapping: $. - path: /projects/{projectId}/users name: getprojectusers operations: - method: GET name: getprojectusers description: Get project users call: n8n.getprojectusers with: projectId: rest.projectId outputParameters: - type: object mapping: $. - path: /projects/{projectId}/users name: addprojectusers operations: - method: POST name: addprojectusers description: Add users to a project call: n8n.addprojectusers with: projectId: rest.projectId outputParameters: - type: object mapping: $. - type: mcp port: 9090 namespace: n8n-mcp transport: http description: MCP adapter for n8n Public API for AI agent use. tools: - name: generateaudit description: Generate an audit hints: readOnly: false destructive: false idempotent: false call: n8n.generateaudit outputParameters: - type: object mapping: $. - name: createcredential description: Create a credential hints: readOnly: false destructive: false idempotent: false call: n8n.createcredential outputParameters: - type: object mapping: $. - name: deletecredential description: Delete credential by ID hints: readOnly: false destructive: true idempotent: true call: n8n.deletecredential with: id: tools.id inputParameters: - name: id type: string description: The credential ID. required: true outputParameters: - type: object mapping: $. - name: testcredential description: Test a credential hints: readOnly: false destructive: false idempotent: false call: n8n.testcredential with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: getcredentialschema description: Show credential data schema hints: readOnly: true destructive: false idempotent: true call: n8n.getcredentialschema with: credentialTypeName: tools.credentialTypeName inputParameters: - name: credentialTypeName type: string description: credentialTypeName required: true outputParameters: - type: object mapping: $. - name: transfercredential description: Transfer a credential to another project hints: readOnly: false destructive: false idempotent: true call: n8n.transfercredential with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: getexecutions description: Retrieve all executions hints: readOnly: true destructive: false idempotent: true call: n8n.getexecutions with: includeData: tools.includeData status: tools.status workflowId: tools.workflowId projectId: tools.projectId limit: tools.limit cursor: tools.cursor inputParameters: - name: includeData type: boolean description: includeData - name: status type: string description: status - name: workflowId type: string description: workflowId - name: projectId type: string description: projectId - name: limit type: number description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: getexecution description: Retrieve an execution hints: readOnly: true destructive: false idempotent: true call: n8n.getexecution with: id: tools.id includeData: tools.includeData inputParameters: - name: id type: number description: id required: true - name: includeData type: boolean description: includeData outputParameters: - type: object mapping: $. - name: deleteexecution description: Delete an execution hints: readOnly: false destructive: true idempotent: true call: n8n.deleteexecution with: id: tools.id inputParameters: - name: id type: number description: id required: true outputParameters: - type: object mapping: $. - name: retryexecution description: Retry an execution hints: readOnly: false destructive: false idempotent: false call: n8n.retryexecution with: id: tools.id inputParameters: - name: id type: number description: id required: true outputParameters: - type: object mapping: $. - name: stopexecution description: Stop an execution hints: readOnly: false destructive: false idempotent: false call: n8n.stopexecution with: id: tools.id inputParameters: - name: id type: number description: id required: true outputParameters: - type: object mapping: $. - name: stopexecutions description: Stop multiple executions hints: readOnly: false destructive: false idempotent: false call: n8n.stopexecutions outputParameters: - type: object mapping: $. - name: updateexecutiontags description: Update tags on an execution hints: readOnly: false destructive: false idempotent: true call: n8n.updateexecutiontags with: id: tools.id inputParameters: - name: id type: number description: id required: true outputParameters: - type: object mapping: $. - name: createtag description: Create a tag hints: readOnly: false destructive: false idempotent: false call: n8n.createtag outputParameters: - type: object mapping: $. - name: gettags description: Retrieve all tags hints: readOnly: true destructive: false idempotent: true call: n8n.gettags with: limit: tools.limit cursor: tools.cursor inputParameters: - name: limit type: number description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: gettag description: Retrieves a tag hints: readOnly: true destructive: false idempotent: true call: n8n.gettag with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: deletetag description: Delete a tag hints: readOnly: false destructive: true idempotent: true call: n8n.deletetag with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: updatetag description: Update a tag hints: readOnly: false destructive: false idempotent: true call: n8n.updatetag with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: createworkflow description: Create a workflow hints: readOnly: false destructive: false idempotent: false call: n8n.createworkflow outputParameters: - type: object mapping: $. - name: getworkflows description: Retrieve all workflows hints: readOnly: true destructive: false idempotent: true call: n8n.getworkflows with: active: tools.active tags: tools.tags name: tools.name projectId: tools.projectId excludePinnedData: tools.excludePinnedData limit: tools.limit cursor: tools.cursor inputParameters: - name: active type: boolean description: active - name: tags type: string description: tags - name: name type: string description: name - name: projectId type: string description: projectId - name: excludePinnedData type: boolean description: excludePinnedData - name: limit type: number description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: getworkflow description: Retrieves a workflow hints: readOnly: true destructive: false idempotent: true call: n8n.getworkflow with: id: tools.id excludePinnedData: tools.excludePinnedData inputParameters: - name: id type: string description: id required: true - name: excludePinnedData type: boolean description: excludePinnedData outputParameters: - type: object mapping: $. - name: deleteworkflow description: Delete a workflow hints: readOnly: false destructive: true idempotent: true call: n8n.deleteworkflow with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: updateworkflow description: Update a workflow hints: readOnly: false destructive: false idempotent: true call: n8n.updateworkflow with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: getworkflowversion description: Retrieves a specific version of a workflow hints: readOnly: true destructive: false idempotent: true call: n8n.getworkflowversion with: id: tools.id versionId: tools.versionId inputParameters: - name: id type: string description: id required: true - name: versionId type: string description: versionId required: true outputParameters: - type: object mapping: $. - name: activateworkflow description: Activate a workflow hints: readOnly: false destructive: false idempotent: false call: n8n.activateworkflow with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: deactivateworkflow description: Deactivate a workflow hints: readOnly: false destructive: false idempotent: false call: n8n.deactivateworkflow with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: archiveworkflow description: Archive a workflow hints: readOnly: false destructive: false idempotent: false call: n8n.archiveworkflow with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: unarchiveworkflow description: Unarchive a workflow hints: readOnly: false destructive: false idempotent: false call: n8n.unarchiveworkflow with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: transferworkflow description: Transfer a workflow to another project hints: readOnly: false destructive: false idempotent: true call: n8n.transferworkflow with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: getworkflowtags description: Get workflow tags hints: readOnly: true destructive: false idempotent: true call: n8n.getworkflowtags with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: updateworkflowtags description: Update tags of a workflow hints: readOnly: false destructive: false idempotent: true call: n8n.updateworkflowtags with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: getusers description: Retrieve all users hints: readOnly: true destructive: false idempotent: true call: n8n.getusers with: limit: tools.limit cursor: tools.cursor includeRole: tools.includeRole projectId: tools.projectId inputParameters: - name: limit type: number description: limit - name: cursor type: string description: cursor - name: includeRole type: boolean description: includeRole - name: projectId type: string description: projectId outputParameters: - type: object mapping: $. - name: createusers description: Create multiple users hints: readOnly: false destructive: false idempotent: false call: n8n.createusers outputParameters: - type: object mapping: $. - name: getuser description: Get user by ID/Email hints: readOnly: true destructive: false idempotent: true call: n8n.getuser with: id: tools.id includeRole: tools.includeRole inputParameters: - name: id type: string description: id required: true - name: includeRole type: boolean description: includeRole outputParameters: - type: object mapping: $. - name: deleteuser description: Delete a user hints: readOnly: false destructive: true idempotent: true call: n8n.deleteuser with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: changeuserrole description: Change a user's global role hints: readOnly: false destructive: false idempotent: false call: n8n.changeuserrole with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: sourcecontrolpull description: Pull changes from the remote repository hints: readOnly: false destructive: false idempotent: false call: n8n.sourcecontrolpull outputParameters: - type: object mapping: $. - name: createvariable description: Create a variable hints: readOnly: false destructive: false idempotent: false call: n8n.createvariable outputParameters: - type: object mapping: $. - name: getvariables description: Retrieve variables hints: readOnly: true destructive: false idempotent: true call: n8n.getvariables with: limit: tools.limit cursor: tools.cursor inputParameters: - name: limit type: number description: limit - name: cursor type: string description: cursor outputParameters: - type: object mapping: $. - name: deletevariable description: Delete a variable hints: readOnly: false destructive: true idempotent: true call: n8n.deletevariable with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: updatevariable description: Update a variable hints: readOnly: false destructive: false idempotent: true call: n8n.updatevariable with: id: tools.id inputParameters: - name: id type: string description: id required: true outputParameters: - type: object mapping: $. - name: listdatatables description: List all data tables hints: readOnly: true destructive: false idempotent: true call: n8n.listdatatables outputParameters: - type: object mapping: $. - name: createdatatable description: Create a data table hints: readOnly: false destructive: false idempotent: false call: n8n.createdatatable outputParameters: - type: object mapping: $. - name: getdatatable description: Get a data table hints: readOnly: true destructive: false idempotent: true call: n8n.getdatatable with: dataTableId: tools.dataTableId inputParameters: - name: dataTableId type: string description: dataTableId required: true outputParameters: - type: object mapping: $. - name: deletedatatable description: Delete a data table hints: readOnly: false destructive: true idempotent: true call: n8n.deletedatatable with: dataTableId: tools.dataTableId inputParameters: - name: dataTableId type: string description: dataTableId required: true outputParameters: - type: object mapping: $. - name: updatedatatable description: Update a data table hints: readOnly: false destructive: false idempotent: false call: n8n.updatedatatable with: dataTableId: tools.dataTableId inputParameters: - name: dataTableId type: string description: dataTableId required: true outputParameters: - type: object mapping: $. - name: listdatatablerows description: List rows in a data table hints: readOnly: true destructive: false idempotent: true call: n8n.listdatatablerows with: dataTableId: tools.dataTableId inputParameters: - name: dataTableId type: string description: dataTableId required: true outputParameters: - type: object mapping: $. - name: insertdatatablerows description: Insert rows into a data table hints: readOnly: false destructive: false idempotent: false call: n8n.insertdatatablerows with: dataTableId: tools.dataTableId inputParameters: - name: dataTableId type: string description: dataTableId required: true outputParameters: - type: object mapping: $. - name: updatedatatablerows description: Update rows in a data table hints: readOnly: false destructive: false idempotent: false call: n8n.updatedatatablerows with: dataTableId: tools.dataTableId inputParameters: - name: dataTableId type: string description: dataTableId required: true outputParameters: - type: object mapping: $. - name: upsertdatatablerows description: Upsert rows in a data table hints: readOnly: false destructive: false idempotent: false call: n8n.upsertdatatablerows with: dataTableId: tools.dataTableId inputParameters: - name: dataTableId type: string description: dataTableId required: true outputParameters: - type: object mapping: $. - name: deletedatatablerows description: Delete rows in a data table hints: readOnly: false destructive: false idempotent: false call: n8n.deletedatatablerows with: dataTableId: tools.dataTableId inputParameters: - name: dataTableId type: string description: dataTableId required: true outputParameters: - type: object mapping: $. - name: listdatatablecolumns description: List columns in a data table hints: readOnly: true destructive: false idempotent: true call: n8n.listdatatablecolumns with: dataTableId: tools.dataTableId inputParameters: - name: dataTableId type: string description: dataTableId required: true outputParameters: - type: object mapping: $. - name: adddatatablecolumn description: Add a column to a data table hints: readOnly: false destructive: false idempotent: false call: n8n.adddatatablecolumn with: dataTableId: tools.dataTableId inputParameters: - name: dataTableId type: string description: dataTableId required: true outputParameters: - type: object mapping: $. - name: deletedatatablecolumn description: Delete a column from a data table hints: readOnly: false destructive: true idempotent: true call: n8n.deletedatatablecolumn with: dataTableId: tools.dataTableId columnId: tools.columnId inputParameters: - name: dataTableId type: string description: dataTableId required: true - name: columnId type: string description: columnId required: true outputParameters: - type: object mapping: $. - name: createproject description: Create a project hints: readOnly: false destructive: false idempotent: false call: n8n.createproject outputParameters: - type: object mapping: $. - name: getprojects description: Retrieve projects hints: readOnly: true destructive: false idempotent: true call: n8n.getprojects outputParameters: - type: object mapping: $. - name: deleteproject description: Delete a project hints: readOnly: false destructive: true idempotent: true call: n8n.deleteproject with: projectId: tools.projectId inputParameters: - name: projectId type: string description: projectId required: true outputParameters: - type: object mapping: $. - name: updateproject description: Update a project hints: readOnly: false destructive: false idempotent: true call: n8n.updateproject with: projectId: tools.projectId inputParameters: - name: projectId type: string description: projectId required: true outputParameters: - type: object mapping: $. - name: getprojectusers description: Get project users hints: readOnly: true destructive: false idempotent: true call: n8n.getprojectusers with: projectId: tools.projectId inputParameters: - name: projectId type: string description: projectId required: true outputParameters: - type: object mapping: $. - name: addprojectusers description: Add users to a project hints: readOnly: false destructive: false idempotent: false call: n8n.addprojectusers with: projectId: tools.projectId inputParameters: - name: projectId type: string description: projectId required: true outputParameters: - type: object mapping: $. binds: - namespace: env keys: N8N_TOKEN: N8N_TOKEN