UNPKG

n8n

Version:

n8n Workflow Automation Tool

1,572 lines 70.5 kB
openapi: 3.0.0 info: title: n8n Public API description: n8n Public API termsOfService: https://n8n.io/legal/#terms contact: email: hello@n8n.io license: name: Sustainable Use License url: https://github.com/n8n-io/n8n/blob/master/LICENSE.md version: 1.1.1 servers: - url: /api/v1 security: - ApiKeyAuth: [] tags: - name: User description: Operations about users - name: Audit description: Operations about security audit - name: Execution description: Operations about executions - name: Workflow description: Operations about workflows - name: Credential description: Operations about credentials - name: Tags description: Operations about tags - name: SourceControl description: Operations about source control - name: Variables description: Operations about variables - name: Projects description: Operations about projects externalDocs: description: n8n API documentation url: https://docs.n8n.io/api/ paths: /audit: post: x-eov-operation-id: generateAudit x-eov-operation-handler: v1/handlers/audit/audit.handler tags: - Audit summary: Generate an audit description: Generate a security audit for your n8n instance. requestBody: required: false content: application/json: schema: type: object properties: additionalOptions: type: object properties: daysAbandonedWorkflow: type: integer description: Days for a workflow to be considered abandoned if not executed categories: type: array items: type: string enum: - credentials - database - nodes - filesystem - instance responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/audit' '401': $ref: '#/components/responses/unauthorized' '500': description: Internal server error. /credentials: post: x-eov-operation-id: createCredential x-eov-operation-handler: v1/handlers/credentials/credentials.handler tags: - Credential summary: Create a credential description: Creates a credential that can be used by nodes of the specified type. requestBody: description: Credential to be created. required: true content: application/json: schema: $ref: '#/components/schemas/credential' responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/create-credential-response' '401': $ref: '#/components/responses/unauthorized' '415': description: Unsupported media type. /credentials/{id}: delete: x-eov-operation-id: deleteCredential x-eov-operation-handler: v1/handlers/credentials/credentials.handler tags: - Credential summary: Delete credential by ID description: Deletes a credential from your instance. You must be the owner of the credentials operationId: deleteCredential parameters: - name: id in: path description: The credential ID that needs to be deleted required: true schema: type: string responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/credential' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' /credentials/schema/{credentialTypeName}: get: x-eov-operation-id: getCredentialType x-eov-operation-handler: v1/handlers/credentials/credentials.handler tags: - Credential summary: Show credential data schema parameters: - name: credentialTypeName in: path description: The credential type name that you want to get the schema for required: true schema: type: string responses: '200': description: Operation successful. content: application/json: schema: type: object examples: freshdeskApi: value: additionalProperties: false type: object properties: apiKey: type: string domain: type: string required: - apiKey - domain slackOAuth2Api: value: additionalProperties: false type: object properties: clientId: type: string clientSecret: type: string required: - clientId - clientSecret '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' /credentials/{id}/transfer: put: x-eov-operation-id: transferCredential x-eov-operation-handler: v1/handlers/credentials/credentials.handler tags: - Credential summary: Transfer a credential to another project. description: Transfer a credential to another project. parameters: - $ref: '#/components/parameters/credentialId' requestBody: description: Destination project for the credential transfer. content: application/json: schema: type: object properties: destinationProjectId: type: string description: The ID of the project to transfer the credential to. required: - destinationProjectId required: true responses: '200': description: Operation successful. '400': $ref: '#/components/responses/badRequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' /executions: get: x-eov-operation-id: getExecutions x-eov-operation-handler: v1/handlers/executions/executions.handler tags: - Execution summary: Retrieve all executions description: Retrieve all executions from your instance. parameters: - $ref: '#/components/parameters/includeData' - name: status in: query description: Status to filter the executions by. required: false schema: type: string enum: - canceled - error - running - success - waiting - name: workflowId in: query description: Workflow to filter the executions by. required: false schema: type: string example: '1000' - name: projectId in: query required: false explode: false allowReserved: true schema: type: string example: VmwOO9HeTEj20kxM - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/cursor' responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/executionList' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' /executions/{id}: get: x-eov-operation-id: getExecution x-eov-operation-handler: v1/handlers/executions/executions.handler tags: - Execution summary: Retrieve an execution description: Retrieve an execution from your instance. parameters: - $ref: '#/components/parameters/executionId' - $ref: '#/components/parameters/includeData' responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/execution' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' delete: x-eov-operation-id: deleteExecution x-eov-operation-handler: v1/handlers/executions/executions.handler tags: - Execution summary: Delete an execution description: Deletes an execution from your instance. parameters: - $ref: '#/components/parameters/executionId' responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/execution' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' /executions/{id}/retry: post: x-eov-operation-id: retryExecution x-eov-operation-handler: v1/handlers/executions/executions.handler tags: - Execution summary: Retry an execution description: Retry an execution from your instance. parameters: - $ref: '#/components/parameters/executionId' requestBody: required: false content: application/json: schema: type: object properties: loadWorkflow: type: boolean description: Whether to load the currently saved workflow to execute instead of the one saved at the time of the execution. If set to true, it will retry with the latest version of the workflow. responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/execution' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' '409': $ref: '#/components/responses/conflict' /tags: post: x-eov-operation-id: createTag x-eov-operation-handler: v1/handlers/tags/tags.handler tags: - Tags summary: Create a tag description: Create a tag in your instance. requestBody: description: Created tag object. content: application/json: schema: $ref: '#/components/schemas/tag' required: true responses: '201': description: A tag object content: application/json: schema: $ref: '#/components/schemas/tag' '400': $ref: '#/components/responses/badRequest' '401': $ref: '#/components/responses/unauthorized' '409': $ref: '#/components/responses/conflict' get: x-eov-operation-id: getTags x-eov-operation-handler: v1/handlers/tags/tags.handler tags: - Tags summary: Retrieve all tags description: Retrieve all tags from your instance. parameters: - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/cursor' responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/tagList' '401': $ref: '#/components/responses/unauthorized' /tags/{id}: get: x-eov-operation-id: getTag x-eov-operation-handler: v1/handlers/tags/tags.handler tags: - Tags summary: Retrieves a tag description: Retrieves a tag. parameters: - $ref: '#/components/parameters/tagId' responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/tag' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' delete: x-eov-operation-id: deleteTag x-eov-operation-handler: v1/handlers/tags/tags.handler tags: - Tags summary: Delete a tag description: Deletes a tag. parameters: - $ref: '#/components/parameters/tagId' responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/tag' '401': $ref: '#/components/responses/unauthorized' '403': $ref: '#/components/responses/forbidden' '404': $ref: '#/components/responses/notFound' put: x-eov-operation-id: updateTag x-eov-operation-handler: v1/handlers/tags/tags.handler tags: - Tags summary: Update a tag description: Update a tag. parameters: - $ref: '#/components/parameters/tagId' requestBody: description: Updated tag object. content: application/json: schema: $ref: '#/components/schemas/tag' required: true responses: '200': description: Tag object content: application/json: schema: $ref: '#/components/schemas/tag' '400': $ref: '#/components/responses/badRequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' '409': $ref: '#/components/responses/conflict' /workflows: post: x-eov-operation-id: createWorkflow x-eov-operation-handler: v1/handlers/workflows/workflows.handler tags: - Workflow summary: Create a workflow description: Create a workflow in your instance. requestBody: description: Created workflow object. content: application/json: schema: $ref: '#/components/schemas/workflow' required: true responses: '200': description: A workflow object content: application/json: schema: $ref: '#/components/schemas/workflow' '400': $ref: '#/components/responses/badRequest' '401': $ref: '#/components/responses/unauthorized' get: x-eov-operation-id: getWorkflows x-eov-operation-handler: v1/handlers/workflows/workflows.handler tags: - Workflow summary: Retrieve all workflows description: Retrieve all workflows from your instance. parameters: - name: active in: query schema: type: boolean example: true - name: tags in: query required: false explode: false allowReserved: true schema: type: string example: test,production - name: name in: query required: false explode: false allowReserved: true schema: type: string example: My Workflow - name: projectId in: query required: false explode: false allowReserved: true schema: type: string example: VmwOO9HeTEj20kxM - name: excludePinnedData in: query required: false description: Set this to avoid retrieving pinned data schema: type: boolean example: true - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/cursor' responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/workflowList' '401': $ref: '#/components/responses/unauthorized' /workflows/{id}: get: x-eov-operation-id: getWorkflow x-eov-operation-handler: v1/handlers/workflows/workflows.handler tags: - Workflow summary: Retrieves a workflow description: Retrieves a workflow. parameters: - name: excludePinnedData in: query required: false description: Set this to avoid retrieving pinned data schema: type: boolean example: true - $ref: '#/components/parameters/workflowId' responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/workflow' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' delete: x-eov-operation-id: deleteWorkflow x-eov-operation-handler: v1/handlers/workflows/workflows.handler tags: - Workflow summary: Delete a workflow description: Deletes a workflow. parameters: - $ref: '#/components/parameters/workflowId' responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/workflow' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' put: x-eov-operation-id: updateWorkflow x-eov-operation-handler: v1/handlers/workflows/workflows.handler tags: - Workflow summary: Update a workflow description: Update a workflow. If the workflow is active, the updated version will be automatically reactivated. parameters: - $ref: '#/components/parameters/workflowId' requestBody: description: Updated workflow object. content: application/json: schema: $ref: '#/components/schemas/workflow' required: true responses: '200': description: Workflow object content: application/json: schema: $ref: '#/components/schemas/workflow' '400': $ref: '#/components/responses/badRequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' /workflows/{id}/{versionId}: get: x-eov-operation-id: getWorkflowVersion x-eov-operation-handler: v1/handlers/workflows/workflows.handler tags: - Workflow summary: Retrieves a specific version of a workflow description: Retrieves a specific version of a workflow from workflow history. parameters: - $ref: '#/components/parameters/workflowId' - name: versionId in: path required: true description: The version ID to retrieve schema: type: string example: abc123-def456-ghi789 responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/workflowVersion' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' /workflows/{id}/activate: post: x-eov-operation-id: activateWorkflow x-eov-operation-handler: v1/handlers/workflows/workflows.handler tags: - Workflow summary: Activate a workflow description: Active a workflow. parameters: - $ref: '#/components/parameters/workflowId' requestBody: description: Optional parameters for workflow activation. content: application/json: schema: type: object properties: versionId: type: string description: The specific version ID to activate. If not provided, activates the latest version. name: type: string description: Optional name for the workflow version during activation. description: type: string description: Optional description for the workflow version during activation. required: false responses: '200': description: Workflow object content: application/json: schema: $ref: '#/components/schemas/workflow' '400': $ref: '#/components/responses/badRequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' /workflows/{id}/deactivate: post: x-eov-operation-id: deactivateWorkflow x-eov-operation-handler: v1/handlers/workflows/workflows.handler tags: - Workflow summary: Deactivate a workflow description: Deactivate a workflow. parameters: - $ref: '#/components/parameters/workflowId' responses: '200': description: Workflow object content: application/json: schema: $ref: '#/components/schemas/workflow' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' /workflows/{id}/transfer: put: x-eov-operation-id: transferWorkflow x-eov-operation-handler: v1/handlers/workflows/workflows.handler tags: - Workflow summary: Transfer a workflow to another project. description: Transfer a workflow to another project. parameters: - $ref: '#/components/parameters/workflowId' requestBody: description: Destination project information for the workflow transfer. content: application/json: schema: type: object properties: destinationProjectId: type: string description: The ID of the project to transfer the workflow to. required: - destinationProjectId required: true responses: '200': description: Operation successful. '400': $ref: '#/components/responses/badRequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' /workflows/{id}/tags: get: x-eov-operation-id: getWorkflowTags x-eov-operation-handler: v1/handlers/workflows/workflows.handler tags: - Workflow summary: Get workflow tags description: Get workflow tags. parameters: - $ref: '#/components/parameters/workflowId' responses: '200': description: List of tags content: application/json: schema: $ref: '#/components/schemas/workflowTags' '400': $ref: '#/components/responses/badRequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' put: x-eov-operation-id: updateWorkflowTags x-eov-operation-handler: v1/handlers/workflows/workflows.handler tags: - Workflow summary: Update tags of a workflow description: Update tags of a workflow. parameters: - $ref: '#/components/parameters/workflowId' requestBody: description: List of tags content: application/json: schema: $ref: '#/components/schemas/tagIds' required: true responses: '200': description: List of tags after add the tag content: application/json: schema: $ref: '#/components/schemas/workflowTags' '400': $ref: '#/components/responses/badRequest' '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' /users: get: x-eov-operation-id: getUsers x-eov-operation-handler: v1/handlers/users/users.handler.ee tags: - User summary: Retrieve all users description: Retrieve all users from your instance. Only available for the instance owner. parameters: - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/cursor' - $ref: '#/components/parameters/includeRole' - name: projectId in: query required: false explode: false allowReserved: true schema: type: string example: VmwOO9HeTEj20kxM responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/userList' '401': $ref: '#/components/responses/unauthorized' post: x-eov-operation-id: createUser x-eov-operation-handler: v1/handlers/users/users.handler.ee tags: - User summary: Create multiple users description: Create one or more users. requestBody: description: Array of users to be created. required: true content: application/json: schema: type: array items: type: object properties: email: type: string format: email role: type: string example: global:member required: - email responses: '200': description: Operation successful. content: application/json: schema: type: object properties: user: type: object properties: id: type: string email: type: string inviteAcceptUrl: type: string emailSent: type: boolean error: type: string '401': $ref: '#/components/responses/unauthorized' '403': $ref: '#/components/responses/forbidden' /users/{id}: get: x-eov-operation-id: getUser x-eov-operation-handler: v1/handlers/users/users.handler.ee tags: - User summary: Get user by ID/Email description: Retrieve a user from your instance. Only available for the instance owner. parameters: - $ref: '#/components/parameters/userIdentifier' - $ref: '#/components/parameters/includeRole' responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/user' '401': $ref: '#/components/responses/unauthorized' delete: x-eov-operation-id: deleteUser x-eov-operation-handler: v1/handlers/users/users.handler.ee tags: - User summary: Delete a user description: Delete a user from your instance. parameters: - $ref: '#/components/parameters/userIdentifier' responses: '204': description: Operation successful. '401': $ref: '#/components/responses/unauthorized' '403': $ref: '#/components/responses/forbidden' '404': $ref: '#/components/responses/notFound' /users/{id}/role: patch: x-eov-operation-id: changeRole x-eov-operation-handler: v1/handlers/users/users.handler.ee tags: - User summary: Change a user's global role description: Change a user's global role parameters: - $ref: '#/components/parameters/userIdentifier' requestBody: description: New role for the user required: true content: application/json: schema: type: object properties: newRoleName: type: string example: global:member required: - newRoleName responses: '200': description: Operation successful. '401': $ref: '#/components/responses/unauthorized' '403': $ref: '#/components/responses/forbidden' '404': $ref: '#/components/responses/notFound' /source-control/pull: post: x-eov-operation-id: pull x-eov-operation-handler: v1/handlers/source-control/source-control.handler tags: - SourceControl summary: Pull changes from the remote repository description: Requires the Source Control feature to be licensed and connected to a repository. requestBody: description: Pull options required: true content: application/json: schema: $ref: '#/components/schemas/pull' responses: '200': description: Import result content: application/json: schema: $ref: '#/components/schemas/importResult' '400': $ref: '#/components/responses/badRequest' '409': $ref: '#/components/responses/conflict' /variables: post: x-eov-operation-id: createVariable x-eov-operation-handler: v1/handlers/variables/variables.handler tags: - Variables summary: Create a variable description: Create a variable in your instance. requestBody: description: Payload for variable to create. content: application/json: schema: $ref: '#/components/schemas/variable.create' required: true responses: '201': description: Operation successful. '400': $ref: '#/components/responses/badRequest' '401': $ref: '#/components/responses/unauthorized' get: x-eov-operation-id: getVariables x-eov-operation-handler: v1/handlers/variables/variables.handler tags: - Variables summary: Retrieve variables description: Retrieve variables from your instance. parameters: - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/cursor' - name: projectId in: query required: false explode: false allowReserved: true schema: type: string example: VmwOO9HeTEj20kxM - name: state in: query required: false schema: type: string enum: - empty responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/variableList' '401': $ref: '#/components/responses/unauthorized' /variables/{id}: delete: x-eov-operation-id: deleteVariable x-eov-operation-handler: v1/handlers/variables/variables.handler tags: - Variables summary: Delete a variable description: Delete a variable from your instance. parameters: - $ref: '#/components/parameters/variableId' responses: '204': description: Operation successful. '401': $ref: '#/components/responses/unauthorized' '404': $ref: '#/components/responses/notFound' put: x-eov-operation-id: updateVariable x-eov-operation-handler: v1/handlers/variables/variables.handler tags: - Variables summary: Update a variable description: Update a variable from your instance. parameters: - $ref: '#/components/parameters/variableId' requestBody: description: Payload for variable to update. content: application/json: schema: $ref: '#/components/schemas/variable.create' required: true responses: '204': description: Operation successful. '400': $ref: '#/components/responses/badRequest' '401': $ref: '#/components/responses/unauthorized' '403': $ref: '#/components/responses/forbidden' '404': $ref: '#/components/responses/notFound' /projects: post: x-eov-operation-id: createProject x-eov-operation-handler: v1/handlers/projects/projects.handler tags: - Projects summary: Create a project description: Create a project on your instance. requestBody: description: Payload for project to create. content: application/json: schema: $ref: '#/components/schemas/project' required: true responses: '201': description: Operation successful. '400': $ref: '#/components/responses/badRequest' '401': $ref: '#/components/responses/unauthorized' get: x-eov-operation-id: getProjects x-eov-operation-handler: v1/handlers/projects/projects.handler tags: - Projects summary: Retrieve projects description: Retrieve projects from your instance. parameters: - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/cursor' responses: '200': description: Operation successful. content: application/json: schema: $ref: '#/components/schemas/projectList' '401': $ref: '#/components/responses/unauthorized' /projects/{projectId}: delete: x-eov-operation-id: deleteProject x-eov-operation-handler: v1/handlers/projects/projects.handler tags: - Projects summary: Delete a project description: Delete a project from your instance. parameters: - in: path name: projectId description: The ID of the project. required: true schema: type: string responses: '204': description: Operation successful. '401': $ref: '#/components/responses/unauthorized' '403': $ref: '#/components/responses/forbidden' '404': $ref: '#/components/responses/notFound' put: x-eov-operation-id: updateProject x-eov-operation-handler: v1/handlers/projects/projects.handler tags: - Projects summary: Update a project description: Update a project on your instance. parameters: - in: path name: projectId description: The ID of the project. required: true schema: type: string requestBody: description: Updated project object. content: application/json: schema: $ref: '#/components/schemas/project' required: true responses: '204': description: Operation successful. '400': $ref: '#/components/responses/badRequest' '401': $ref: '#/components/responses/unauthorized' '403': $ref: '#/components/responses/forbidden' '404': $ref: '#/components/responses/notFound' /projects/{projectId}/users: post: x-eov-operation-id: addUsersToProject x-eov-operation-handler: v1/handlers/projects/projects.handler tags: - Projects summary: Add one or more users to a project description: Add one or more users to a project on your instance. parameters: - name: projectId in: path description: The ID of the project. required: true schema: type: string requestBody: description: Payload containing an array of one or more users to add to the project. content: application/json: schema: type: object properties: relations: type: array description: A list of userIds and roles to add to the project. items: type: object properties: userId: type: string description: The unique identifier of the user. example: 91765f0d-3b29-45df-adb9-35b23937eb92 role: type: string description: The role assigned to the user in the project. example: project:viewer required: - userId - role required: - relations responses: '201': description: Operation successful. '401': $ref: '#/components/responses/unauthorized' '403': $ref: '#/components/responses/forbidden' '404': $ref: '#/components/responses/notFound' /projects/{projectId}/users/{userId}: delete: x-eov-operation-id: deleteUserFromProject x-eov-operation-handler: v1/handlers/projects/projects.handler tags: - Projects summary: Delete a user from a project description: Delete a user from a project on your instance. parameters: - name: projectId in: path description: The ID of the project. required: true schema: type: string - name: userId in: path description: The ID of the user. required: true schema: type: string responses: '204': description: Operation successful. '401': $ref: '#/components/responses/unauthorized' '403': $ref: '#/components/responses/forbidden' '404': $ref: '#/components/responses/notFound' patch: x-eov-operation-id: changeUserRoleInProject x-eov-operation-handler: v1/handlers/projects/projects.handler tags: - Projects summary: Change a user's role in a project description: Change a user's role in a project. parameters: - name: projectId in: path description: The ID of the project. required: true schema: type: string - name: userId in: path description: The ID of the user. required: true schema: type: string requestBody: description: Payload containing the new role to assign to the project user. content: application/json: schema: type: object properties: role: type: string description: The role assigned to the user in the project. example: project:viewer required: - role responses: '204': description: Operation successful. '401': $ref: '#/components/responses/unauthorized' '403': $ref: '#/components/responses/forbidden' '404': $ref: '#/components/responses/notFound' components: schemas: audit: type: object properties: Credentials Risk Report: type: object example: risk: credentials sections: - title: Credentials not used in any workflow description: These credentials are not used in any workflow. Keeping unused credentials in your instance is an unneeded security risk. recommendation: Consider deleting these credentials if you no longer need them. location: - kind: credential id: '1' name: My Test Account Database Risk Report: type: object example: risk: database sections: - title: Expressions in "Execute Query" fields in SQL nodes description: This SQL node has an expression in the "Query" field of an "Execute Query" operation. Building a SQL query with an expression may lead to a SQL injection attack. recommendation: Consider using the "Query Parameters" field to pass parameters to the query or validating the input of the expression in the "Query" field.: null location: - kind: node workflowId: '1' workflowName: My Workflow nodeId: 51eb5852-ce0b-4806-b4ff-e41322a4041a nodeName: MySQL nodeType: n8n-nodes-base.mySql Filesystem Risk Report: type: object example: risk: filesystem sections: - title: Nodes that interact with the filesystem description: This node reads from and writes to any accessible file in the host filesystem. Sensitive file content may be manipulated through a node operation. recommendation: Consider protecting any sensitive files in the host filesystem or refactoring the workflow so that it does not require host filesystem interaction.: null location: - kind: node workflowId: '1' workflowName: My Workflow nodeId: 51eb5852-ce0b-4806-b4ff-e41322a4041a nodeName: Ready Binary file nodeType: n8n-nodes-base.readBinaryFile Nodes Risk Report: type: object example: risk: nodes sections: - title: Community nodes description: This node is sourced from the community. Community nodes are not vetted by the n8n team and have full access to the host system. recommendation: Consider reviewing the source code in any community nodes installed in this n8n instance and uninstalling any community nodes no longer used.: null location: - kind: community nodeType: n8n-nodes-test.test packageUrl: https://www.npmjs.com/package/n8n-nodes-test Instance Risk Report: type: object example: risk: execution sections: - title: Unprotected webhooks in instance description: These webhook nodes have the "Authentication" field set to "None" and are not directly connected to a node to validate the payload. Every unprotected webhook allows your workflow to be called by any third party who knows the webhook URL. recommendation: Consider setting the "Authentication" field to an option other than "None" or validating the payload with one of the following nodes.: null location: - kind: community nodeType: n8n-nodes-test.test packageUrl: https://www.npmjs.com/package/n8n-nodes-test credential: required: - name - type - data type: object properties: id: type: string readOnly: true example: R2DjclaysHbqn778 name: type: string example: Joe's Github Credentials type: type: string example: githubApi data: type: object writeOnly: true example: accessToken: ada612vad6fa5df4adf5a5dsf4389adsf76da7s isResolvable: type: boolean example: false description: Whether this credential has resolvable fields createdAt: type: string format: date-time readOnly: true example: '2022-04-29T11:02:29.842Z' updatedAt: type: string format: date-time readOnly: true example: '2022-04-29T11:02:29.842Z' create-credential-response: required: - id - name - type - createdAt - updatedAt type: object properties: id: type: string readOnly: true example: vHxaz5UaCghVYl9C name: type: string example: John's Github account type: type: string example: githubApi createdAt: type: string format: date-time readOnly: true example: '2022-04-29T11:02:29.842Z' updatedAt: type: string format: date-time readOnly: true example: '2022-04-29T11:02:29.842Z' execution: type: object properties: id: type: number example: 1000 data: type: object finished: type: boolean example: true mode: type: string enum: - cli - error - integrated - internal - manual - retry - trigger - webhook - evaluation - chat retryOf: type: number nullable: true retrySuccessId: type: number nullable: true example: '2' startedAt: type: string format: date-time stoppedAt: type: string format: date-time nullable: true description: The time at which the execution stopped. Will only be null for executions that still have the status 'running'. workflowId: type: number example: '1000' waitTill: type: string nullable: true format: date-time customData: type: object status: type: string enum: - canceled - crashed - error - new - running - success - unknown - waiting executionList: type: object properties: data: type: array items: $ref: '#/components/schemas/execution' nextCursor: type: string description: Paginate through executions by setting the cursor parameter to a nextCursor attribute returned by a previous request. Default value fetches the first "page" of the collection. nullable: true example: MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA tag: type: object additionalProperties: false required: - name properties: id: type: string readOnly: true example: 2tUt1wbLX592XDdX name: type: string example: Production createdAt: type: string format: date-time readOnly: true updatedAt: type: string format: date-time readOnly: true tagList: type: object properties: data: type: array items: $ref: '#/components/schemas/tag' nextCursor: type: string description: Paginate through tags by setting the cursor parameter to a nextCursor attribute returned by a previous request. Default value fetches the first "page" of the collection. nullable: true example: MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA node: type: object additionalProperties: false properties: id: type: string example: 0f5532f9-36ba-4bef-86c7-30d607400b15 name: type: string example: Jira webhookId: type: string disabled: type: boolean notesInFlow: type: boolean notes: type: string type: type: string example: n8n-nodes-base.jira typeVersion: type: number example: 1 executeOnce: type: boolean example: false alwaysOutputData: type: boolean example: false retryOnFail: type: boolean example: false maxTries: type: number waitBetweenTries: type: number continueOnFail: type: boolean example: false description: use onError instead deprecated: tr