# Oncall service contract

`openapi.yaml` is the source of truth for the stable machine-to-machine Oncall
API. It intentionally contains only endpoints supported for other services;
the legacy admin UI API remains documented in `services/oncall/swagger.yaml`.

The canonical shared-gateway prefix is `/api/v1/oncall`. During the migration,
the service also keeps the legacy `/api/v1` routes available for existing
clients and the current standalone frontend.

Go callers share only the API structures from the existing contracts module:

```go
import oncallapi "github.com/tidbcloud/aisupport/packages/sdk-go/contracts/api/oncall"
```