---
title: "GraphQL subscription (WebSocket upgrade)"
method: GET
path: "/v1/graphql"
tags: ["graphql"]
---

# GraphQL subscription (WebSocket upgrade)

`GET /v1/graphql`

Upgrades the connection to a WebSocket speaking the `graphql-transport-ws` subprotocol for GraphQL subscriptions. Requests that do NOT send `Upgrade: websocket` are rejected with 405. Query-string GraphQL (`?query=`) is intentionally not supported — mutations and queries must use POST.

## Other responses

- `101` — Switching Protocols — WebSocket handshake accepted
- `405` — Plain GET without a WebSocket upgrade is not supported

---

[API](https://skmtc.dev/nhost/apis/nhost-constellation-api.md) · [All operations](https://skmtc.dev/nhost/apis/nhost-constellation-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nhost/nhost-constellation-api/revisions/d676467fb711/schema)