# Add API Version

> 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.

- Skill: `oxidecomputer/add-api-version` (Agent Skill)
- Install (CLI): `npx skillmds@latest add oxidecomputer/add-api-version`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oxidecomputer/add-api-version/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: oxidecomputer (https://skillmd.com/u/oxidecomputer)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/oxidecomputer/add-api-version

---


# Add API version

Add a new version to a Dropshot API in this repository.

## Instructions

Follow these steps in order. Do not skip ahead.

### Step 1: Fetch the guide

Fetch the guide from the dropshot-api-manager repository:

```bash
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.

### Step 2: Ascertain the scope of the request

If not already provided, ask the user:

* Which API they would like to change.
* What changes to make.

### Step 3: Make the change

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.