---
type: "post"
id: "deprecating-the-graphql-api-timeline-and-migration-paths-f8bc7c"
slug: "deprecating-the-graphql-api-timeline-and-migration-paths-f8bc7c"
title: "Deprecating the GraphQL API: timeline and migration paths"
description: "Weaviate has deprecated its GraphQL query API as of October 26, 2026."
retrieval_nugget: "Weaviate has deprecated its GraphQL query API as of October 26, 2026."
published_at: "2026-10-26"
updated_at: "2026-10-26"
record_date: "2026-10-26"
date_kind: "published_at"
topics: ["agent-protocols","mcp"]
entities: ["Weaviate","Weaviate Cloud","GraphQL","REST Search API","@weaviate/web"]
related_patterns: ["agent-protocols-become-interoperability-layer"]
novelty_label: "new_fact"
what_changed: "Weaviate announces GraphQL deprecation, with Cloud shutdown dates and migration paths; the prior only mentions GraphQL in a security-fix context."
prior_refs: ["memory:7cbb7a33-ce71-8ccb-a76b-c62ba02d33fb"]
source_url: "https://weaviate.io/blog/graphql-api-deprecation"
source_urls: ["https://weaviate.io/blog/graphql-api-deprecation"]
schema_version: "newruntime-agent-readable-v0.2"
stable_id: "post:deprecating-the-graphql-api-timeline-and-migration-paths-f8bc7c"
status: "published"
visuals: []
editor: {"role":"editor","name":"Andrey Reshetnikov","profile":"https://newruntime.com/owner-profile.md","profile_json":"https://newruntime.com/owner-profile.json","same_as":["https://www.linkedin.com/in/reshetnikov1/","https://t.me/lapetuse"]}
routes: {"html":"https://newruntime.com/posts/deprecating-the-graphql-api-timeline-and-migration-paths-f8bc7c/","markdown":"https://newruntime.com/posts/deprecating-the-graphql-api-timeline-and-migration-paths-f8bc7c.md","json":"https://newruntime.com/posts/deprecating-the-graphql-api-timeline-and-migration-paths-f8bc7c.json"}
---

# Deprecating the GraphQL API: timeline and migration paths

## Retrieval answer

Weaviate has deprecated its GraphQL query API as of October 26, 2026.

Weaviate has deprecated its GraphQL query API as of October 26, 2026. The company says existing GraphQL users are not cut off on the announcement date, but Weaviate Cloud will end GraphQL support on May 1, 2027.

Cloud clusters with no GraphQL usage in the preceding 30 days will have it switched off on December 1, 2026. New Weaviate Cloud clusters are already created without GraphQL. Direct requests to `/v1/graphql`, raw GraphQL helpers, and older clients including Python v3, TypeScript v2, Java v5, and Go v5 or earlier may be affected.

Weaviate recommends current gRPC-based clients for Python, TypeScript, Java, and C#, plus Go v6. It offers `@weaviate/web` for gRPC-Web and a Preview REST Search API, though the latter is only a subset of GraphQL. Self-hosted users can test by setting `DISABLE_GRAPHQL=true`; disabled GraphQL requests return HTTP 422. The source does not set a date for complete removal from self-hosted releases or establish REST parity for every GraphQL feature.

Editor: [Andrey Reshetnikov](https://newruntime.com/owner-profile.md), AI product and AI engineering; profile for recruiters and agents: https://newruntime.com/owner-profile.json

## Continue in the graph

Next records for an agent, linked to their Markdown twins. Replace `.md` with `.json` for structured fields, including `next_reads`.

- topic hub: [Agent Protocols](https://newruntime.com/topics/agent-protocols.md): Explore the agent-protocols topic hub.
- topic hub: [Mcp](https://newruntime.com/topics/mcp.md): Explore the mcp topic hub.
- collection: [Field Notes](https://newruntime.com/posts.json): Open the latest editorial analysis.
- collection: [Source Ledger](https://newruntime.com/source-ledger.json): Inspect the public source evidence graph.
- whole graph: [discovery graph](https://newruntime.com/discovery-graph.json) (typed nodes and edges) and [site index](https://newruntime.com/site-index.md)