Quick Summary: If you are integrated with the SkillsDB GraphQL API today, nothing changes for you. The REST API is an addition, not a replacement, and you are not being asked to migrate.
The position, plainly
SkillsDB now offers two integration surfaces: this GraphQL API and a REST API with API-key authentication. The REST API exists because some customers asked for API keys and a conventional REST shape — not because GraphQL is going away.- No migration is required or planned. Your existing GraphQL integration continues to work, on the same endpoint, with the same authentication.
- No deprecation clock is running. If that ever changes, you will hear it from us directly and in writing, with a generous timeline — not by discovering a notice in a changelog.
- The GraphQL API continues to be maintained. It is the same API our own application runs on, so it receives the same operational attention as the product itself.
What has actually changed for GraphQL integrators
Two improvements, both in your favour:- Schema introspection is now available to authenticated callers. Previously the schema was not readable outside our own environments; now any authenticated request can run introspection — enabling schema discovery, client code generation, GraphQL IDE tooling, and visibility of
@deprecatedmarkers, which are GraphQL’s in-band signal that a field is scheduled to change. Anonymous callers still cannot introspect. - A breaking-change gate now guards the schema in CI. A change that would remove or narrow anything you use cannot merge without an explicit, ticketed approval — the schema can no longer change out from under you as a side effect of a refactor.