API Versioning - Ever Gauzy™ Platform

Current Version

The Ever Gauzy API is currently unversioned — all endpoints are served at /api/.

https://api.yourdomain.com/api/employee

When breaking changes are introduced, the API will adopt URI-based versioning:

https://api.yourdomain.com/api/v1/employee
https://api.yourdomain.com/api/v2/employee

app.enableVersioning({
  type: VersioningType.URI,
  defaultVersion: "1",
});

@Controller({ path: "employee", version: "2" })
export class EmployeeV2Controller {
  // v2 endpoints
}

@Get()
@Version('1')
findAllV1() { ... }

@Get()
@Version('2')
findAllV2() { ... }

Phase	Duration	Action
Announcement	—	Release notes, docs update
Deprecated	6 months	Sunset header added, warnings logged
Removed	—	Endpoint returns 410 Gone

Sunset: Sat, 01 Jun 2025 00:00:00 GMT
Deprecation: true
Link: <https://docs.gauzy.co/migration>; rel="successor-version"

GraphQL APIs evolve through field-level deprecation:

type Employee {
  name: String @deprecated(reason: "Use firstName and lastName")
  firstName: String
  lastName: String
}