Use when making changes to the OpenAPI contract. Workflow for updating spec and regenerating clients.
OpenAPI Change Workflow
Edit the spec: Agent API changes use contracts/openapi/openapi.yml; Admin API changes use contracts/openapi/openapi-admin.yml.
Regenerate Go bindings:
# Agent API + client
go run github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen --config=internal/generated/api/cfg.yaml contracts/openapi/openapi.yml
go run github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen --config=internal/generated/apiclient/cfg.yaml contracts/openapi/openapi.yml
# Admin API
go run github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen --config=internal/generated/admin/cfg.yaml contracts/openapi/openapi-admin.yml