Skip to content

Blog: Deprecating the GraphQL API - #3723

Open
g-despot wants to merge 5 commits into
mainfrom
blog/graphql-api-deprecation
Open

g-despot wants to merge 5 commits into
mainfrom
blog/graphql-api-deprecation

Conversation

@g-despot

@g-despot g-despot commented Oct 1, 2026

Copy link
Copy Markdown
Contributor

Announcement post for the GraphQL API deprecation: the timeline (deprecated October 12, 2026, switched off on Weaviate Cloud on April 1, 2027, disabled by default in self-hosted in a later minor), who is affected per client, why we are deprecating it, the three replacement paths, one query shown as GraphQL, Python and REST Search, and how to migrate. Byline Ivan + Dirk.

Hold until October 12. The docs changes it links to (deprecation notices and the listed migration guide) go out in a weaviate/docs PR that must merge first.

Open items, marked TODO(ivan) in the source: the self-hosted minor that disables GraphQL by default, the release status of REST Search, @weaviate/web and Go v6 on the day, what happens to GraphQL-only features, Cloud switch-off mechanics, and the hero image (placeholder).

@orca-security-eu orca-security-eu Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Orca Security Scan Summary

Status Check Issues by priority
Passed Passed Infrastructure as Code high 0   medium 0   low 0   info 0 View in Orca
Passed Passed SAST high 0   medium 0   low 0   info 0 View in Orca
Passed Passed Secrets high 0   medium 0   low 0   info 0 View in Orca
Passed Passed Vulnerabilities high 0   medium 0   low 0   info 0 View in Orca

Comment thread blog/2026-10-12-graphql-api-deprecation/index.mdx
Comment thread blog/2026-10-12-graphql-api-deprecation/img/timeline.png
Comment thread blog/2026-10-12-graphql-api-deprecation/index.mdx
- You send HTTP requests to `/v1/graphql` directly.
- You use a raw GraphQL helper in a client, such as `graphql_raw_query()` in Python.
- You run an older client generation: the Python v3 API (`weaviate.Client`), `weaviate-ts-client` v2, or the Java client v5 and earlier.
- You use the Go client. The current stable Go client, v5, queries over GraphQL. Go client v6 uses gRPC and is a release candidate today.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we already have some doc for v6 that we can link?

Comment thread blog/2026-10-12-graphql-api-deprecation/index.mdx

Here is one near-text search on a `Movie` collection: five "space opera" movies from 1980 or later in the `scifi` category, with title, year and distance.

<Tabs groupId="languages">

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is super nice! Could we also add a TS example for the migration to the WEB client?

Comment thread blog/2026-10-12-graphql-api-deprecation/index.mdx
Comment thread blog/2026-10-12-graphql-api-deprecation/index.mdx

On Weaviate older than v1.29, the Python and TypeScript clients fall back to GraphQL for aggregations.

You **are affected** if any of these apply:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I find this hard to read but dont have a better idea 😓

Comment thread blog/2026-10-12-graphql-api-deprecation/index.mdx
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants