---
title: "Migrate account to new billing system"
method: POST
path: "/v1/credits/migrate"
tags: ["Money"]
---

# Migrate account to new billing system

`POST /v1/credits/migrate`

Migrates your account from the legacy billing system to the new credit-based billing system.

This endpoint supports two migration options:
- **Withdraw**: Transfer your account balance to an external bank account
- **Convert to Credits**: Convert your existing balance to credits for use in the new system

The migration process will:
- Check your current account balance
- Verify that your account is eligible for automatic migration
- Process the migration according to your chosen option

**Note**: Some accounts with complex balance states may require manual migration assistance. In such cases, the response will indicate `requires_manual_migration` and our support team will help you complete the process.

## Request body

- union — Request body for migrating an account to the new billing system.
  - object — Withdraw the account balance to an external bank account
    - `column_counterparty_id` string, required — The identifier for your external bank account where funds will be transferred
    - `type` 'withdraw', required
  - object — Convert the account balance to credits in the new billing system
    - `type` 'convert_to_credits', required

## Response `200`

Account successfully migrated

- 'migrated' | 'requires_manual_migration' — Response body for account migration requests.

## Other responses

- `401` — Unauthorized - missing or invalid authentication token
- `409` — Account already migrated
- `500` — Internal server error

---

[API](https://skmtc.net/sfcompute/apis/san-francisco-compute-documentation.md) · [All operations](https://skmtc.net/sfcompute/apis/san-francisco-compute-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sfcompute/san-francisco-compute-documentation/revisions/93dd7661e9bb/schema)