// Add a new version to a Dropshot HTTP API. Use when the user wants to make versioned changes to a Dropshot-managed HTTP API, such as adding, making changes to, or removing an API endpoint.
| name | add-api-version |
| description | Add a new version to a Dropshot HTTP API. Use when the user wants to make versioned changes to a Dropshot-managed HTTP API, such as adding, making changes to, or removing an API endpoint. |
Add a new version to a Dropshot API in this repository.
Follow these steps in order. Do not skip ahead.
Fetch the guide from the dropshot-api-manager repository:
curl -fsSL https://raw.githubusercontent.com/oxidecomputer/dropshot-api-manager/refs/heads/main/guides/new-version.md
Do not summarize the guide. Read and follow it exactly as written. Remember to fetch RFD 619 for context.
If not already provided, ask the user:
Follow the guide carefully and systematically to add a new version to the provided API which makes the given changes.
Follow the guide step by step; do not skip any steps.
Generate CockroachDB SQL and migrations for schema changes. Use when creating migrations, updating the database schema, or when the user mentions migrations, schema changes, or dbinit.sql.
Add a new Nexus background task. Use when the user wants to create a periodic background task in Nexus that runs on a timer.