n8n - 💡(How to fix) Fix AI Agent tools fail with “schema must be type: 'object', got 'None'” in n8n v2.17 (works in v2.15) [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
n8n-io/n8n#29353Fetched 2026-04-28 06:49:13
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
0
Author
Timeline (top)
commented ×1labeled ×1mentioned ×1subscribed ×1

Error Message

When using an AI Agent with OpenAI chat models and connecting tools (Google Docs, Google Calendar, etc.), the Agent fails before it can call any tool and returns an error like: The AI Agent fails with an error similar to: The error message suggests that the tool’s JSON schema sent to OpenAI has type: None instead of type: "object". Based on other reports with vector store tools, this kind of error can happen when the tool definition (name/description/schema) is incomplete or when the tool node generates an invalid schema for function calling. The full error stack trace from the logs

Fix Action

Fix / Workaround

Any recommended workaround besides downgrading back to 2.15?

RAW_BUFFERClick to expand / collapse

Bug Description

Hi team,

I’m seeing a breaking issue with AI Agent tools after upgrading n8n. The exact same setup works perfectly on v2.15, but fails on v2.17.x.

Environment n8n version: 2.17.x

Deployment: self-hosted

AI provider: OpenAI

Model: (e.g. gpt-4.1-mini, gpt-4o, etc.)

Affected nodes: AI Agent + tools (Google Docs, Google Calendar, etc.)

Summary When using an AI Agent with OpenAI chat models and connecting tools (Google Docs, Google Calendar, etc.), the Agent fails before it can call any tool and returns an error like:

schema must be type: "object", got "None"

If I downgrade the exact same instance to n8n v2.15, and recreate the workflow from scratch with the same tools, credentials, and model, everything works without any errors.

So this looks like a regression in how tool schemas are generated/validated in v2.17.x.

What I’m doing Create a new workflow from scratch on n8n 2.17.x.

Add an AI Agent node using an OpenAI chat model.

Add one or more tools, for example:

Google Docs tool

Google Calendar tool

Connect those tool nodes to the Agent’s Tools input.

Run the workflow and send a prompt that should trigger one of the tools.

Expected behavior The AI Agent should be able to call the tools normally (as it does in n8n 2.15).

No schema errors should be thrown as long as the tool nodes are configured correctly.

Actual behavior The AI Agent fails with an error similar to:

schema must be type: "object", got "None"

This happens even with brand new workflows created directly on 2.17.x (not migrated ones).

Downgrading n8n back to 2.15 and recreating the same workflow makes the issue disappear.

Notes / Observations The error message suggests that the tool’s JSON schema sent to OpenAI has type: None instead of type: "object".

Based on other reports with vector store tools, this kind of error can happen when the tool definition (name/description/schema) is incomplete or when the tool node generates an invalid schema for function calling.

In my case, I’m just using the standard Google Docs / Calendar tools exposed to the AI Agent, not any custom schema. The only variable that changes is the n8n version.

Questions Is there any known change in v2.17.x that would require a different way of defining tools for AI Agents?

Are there known issues around tools generating type: None schemas in 2.17.x similar to the vector-store tool regressions in other versions?

Any recommended workaround besides downgrading back to 2.15?

I’m happy to provide:

Screenshots of the AI Agent and tool node configuration

The full error stack trace from the logs

A minimal export of the failing workflow

Thanks a lot for your help and for n8n!

To Reproduce

Create an AI agent, add google docs tool and run

Expected behavior

In 2.15 works normaly

Debug Info

schema must be type: 'object', got 'None

Operating System

macos

n8n Version

2.7.8

Node.js Version

24

Database

SQLite (default)

Execution mode

main (default)

Hosting

self hosted

extent analysis

TL;DR

Downgrade to n8n version 2.15 as a temporary workaround to resolve the schema validation error with AI Agent tools.

Guidance

  • Verify that the issue is specific to n8n version 2.17.x by testing with different versions to confirm the regression.
  • Check the tool node configurations for any potential issues, although the report suggests that standard Google Docs and Calendar tools are being used.
  • Consider providing the full error stack trace from the logs and a minimal export of the failing workflow for further assistance.
  • Investigate known issues or changes in n8n version 2.17.x that may affect tool schema generation or validation.

Notes

The provided information suggests a regression in n8n version 2.17.x, but without further details or code changes, it's challenging to provide a definitive fix. The workaround of downgrading to version 2.15 may not be suitable for all users, especially if they rely on features introduced in later versions.

Recommendation

Apply the workaround of downgrading to n8n version 2.15, as it has been confirmed to resolve the issue in the reported scenario.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

In 2.15 works normaly

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

n8n - 💡(How to fix) Fix AI Agent tools fail with “schema must be type: 'object', got 'None'” in n8n v2.17 (works in v2.15) [1 comments, 2 participants]