api/

API models

This directory includes API version specific models from open api specs. The models in this directory is used for serializing/deserializing request and response. datamodels has the converters to convert between version specific models and datamodels. datamodels will be used for internal controller and datastorage.

Generate new models

The versioned models in this directory are generated from the TypeSpec definitions in the typespec directory using the TypeSpec Go emitter (@azure-tools/typespec-go). AutoRest is no longer used to generate these models (see radius-project/radius#11425).

Prerequisites

1. Install NodeJS

Add new api-version

1. Create or update the applicable TypeSpec files under the matching project in the typespec directory.

2. Generate the models and client by running:

   make generate-rad-corerp-client
   

   For the 2025-08-01-preview api-version use make generate-rad-corerp-client-2025-08-01-preview, or run make generate to regenerate every namespace.

3. Create or modify the corresponding datamodels in datamodel

4. Add the converter between versioned model and datamodel in converter