> ## Documentation Index
> Fetch the complete documentation index at: https://doc.rapida.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create new version

> Quick guide to updating your existing endpoint with a new version.

<Note>
  New versions require manual deployment to update the production version.
</Note>

## Step-by-Step Guide

<Steps>
  <Step title="Access Endpoint Settings">
    1. Go to Deployment section
    2. Select the endpoint to update
    3. Click "Create new version"
  </Step>

  <Step title="Modify Endpoint">
    * **Change Endpoint Definition**: Adjust model, instructions, variables
    * **Update Model Settings**: Fine-tune parameters (e.g., temperature, max tokens)
    * **Revise Instructions**: Edit system/user messages, modify arguments

          <img src="https://mintcdn.com/rapidaai/iFtJHOhZE0HHFT_Q/images/endpoint/modify-endpoint-image.png?fit=max&auto=format&n=iFtJHOhZE0HHFT_Q&q=85&s=d74e4edeb038af76b9040928e12d1770" alt="Modify Endpoint Interface" width="3600" height="2020" data-path="images/endpoint/modify-endpoint-image.png" />
  </Step>

  <Step title="Describe Changes">
    Enter a brief description of modifications in the "Change Description" field.

    <img src="https://mintcdn.com/rapidaai/iFtJHOhZE0HHFT_Q/images/endpoint/change-endpoint-image.png?fit=max&auto=format&n=iFtJHOhZE0HHFT_Q&q=85&s=f8afa476f324a8429d541aae6f78bc54" alt="Modify Endpoint Interface" width="3600" height="2022" data-path="images/endpoint/change-endpoint-image.png" />
  </Step>

  <Step title="Manage Versions">
    * View "Version history"
    * Compare versions if needed
    * Deploy new version when ready

          <img src="https://mintcdn.com/rapidaai/iFtJHOhZE0HHFT_Q/images/endpoint/version-history-image.png?fit=max&auto=format&n=iFtJHOhZE0HHFT_Q&q=85&s=f2af24c89fdf1a019f54e3e1f6085f96" alt="Version History Interface" width="3600" height="2020" data-path="images/endpoint/version-history-image.png" />
  </Step>
</Steps>

## Best Practices

* Use clear change logs
* Test thoroughly before deployment
* Consider separate dev/prod endpoints
* Review performance metrics regularly