Summary
The CircleCI GraphQL Unstable API (https://circleci.com/graphql-unstable) will reach end of life on January 1, 2027 and will no longer be supported or accessible after that date. This change does not impact Server customers.
What’s changing
- Endpoint deprecated: https://circleci.com/graphql-unstable
- End of support date: January 1, 2027
- Impact: Any integrations, scripts, or tooling that call this endpoint will stop working after the EOL date.
What you should do
- Migrate to the CircleCI V3 REST API, which provides equivalent and expanded functionality with stable, versioned endpoints.
- Upgrade your CIrcleCi CLI to V1, if you are still using V0. V3 API documentation: https://circleci.com/docs/api/v3/
Migration steps
- Review your current usage of https://circleci.com/graphql-unstable.
- Identify the corresponding V3 REST API endpoints for each query or mutation.
- Update your integration to use the V3 endpoints.
- Test your integration before the January 1, 2027 deadline.
Why this change
The graphql-unstable endpoint was never intended as a stable, production API. The V3 REST API offers:
- Stable, versioned endpoints with a formal deprecation policy
- Improved performance and reliability
- Comprehensive documentation and support
Timeline
- January 1, 2027
- Endpoint shut down; all requests will fail
Need help?
If you have questions or need assistance migrating, contact CircleCI Support or visit our API documentation.