---
title: "Switch a running Monthly drive (retired 18 Oct 2026) for one product between monthly and yearly billing; the change is prorated and invoiced at once"
method: POST
path: "/api/billing/switch"
tags: ["Orders"]
---

# Switch a running Monthly drive (retired 18 Oct 2026) for one product between monthly and yearly billing; the change is prorated and invoiced at once

`POST /api/billing/switch`

## Request

- Base URL: `https://agentdrives.com`
- URL: `https://agentdrives.com/api/billing/switch`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

## Request body

- object
  - `order_id` string, required
  - `to` 'month' | 'year', required

## Response `200`

Switched

## Other responses

- `400`: Error as problem details (RFC 9457) with a machine-readable `error` and a `fix` that says what to do next
- `404`: Error as problem details (RFC 9457) with a machine-readable `error` and a `fix` that says what to do next
- `409`: cancelling: undo the cancellation first; legacy_plan: a subscription from before 10 Oct 2026 keeps its price

---

[API](https://skmtc.dev/agentdrives/apis/agentdrives-api.md) · [All operations](https://skmtc.dev/agentdrives/apis/agentdrives-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentdrives/apis/agentdrives-api/revisions/94dcaabff4b2?raw)