> For the complete documentation index, see [llms.txt](https://docs.alignlabs.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alignlabs.dev/align-api/virtual-accounts/update-virtual-account.md).

# Update Virtual Account

## Update Virtual Account

> Updates the destination address and/or developer fee of an existing active virtual account

```json
{"openapi":"3.0.0","info":{"title":"Virtual Accounts API","version":"0"},"servers":[{"url":"https://api.alignlabs.dev","description":"Production server"},{"url":"https://api-sandbox.alignlabs.dev","description":"Sandbox server"}],"paths":{"/v0/customers/{customer_id}/virtual-account/{virtual_account_id}":{"put":{"summary":"Update Virtual Account","description":"Updates the destination address and/or developer fee of an existing active virtual account","parameters":[{"name":"customer_id","in":"path","description":"The unique identifier of the customer","required":true,"schema":{"type":"string"}},{"name":"virtual_account_id","in":"path","description":"The unique identifier of the virtual account","required":true,"schema":{"type":"string"}},{"name":"Api-Key","in":"header","description":"Your secret API key, available in the developer dashboard. Include this header on every request to authenticate your application.","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateVABodyModel"}}}},"responses":{"200":{"description":"Successfully updated virtual account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateVAResponseSuccessModel"}}}},"400":{"description":"Bad request — invalid destination address format or virtual account is not active"},"404":{"description":"Virtual account not found"}}}}},"components":{"schemas":{"UpdateVABodyModel":{"type":"object","description":"At least one of the fields must be provided","properties":{"destination_address":{"type":"string","description":"The new blockchain address where the funds will be sent"},"developer_fee_percent":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?$","description":"Custom developer fee percentage for the Virtual Account"},"destination_token":{"type":"string","description":"The currency to be deposited","enum":["usdc","usdt","eurc"]}}},"CreateVAResponseSuccessModel":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier for the virtual account"},"status":{"type":"string","description":"The current status of the virtual account","enum":["active"]},"destination_token":{"type":"string","description":"The currency to be deposited","enum":["usdc","usdt","aed"]},"destination_network":{"type":"string","description":"The blockchain network for the destination","enum":["polygon","ethereum","solana","base","tron","arbitrum"]},"destination_address":{"type":"string","description":"The blockchain address where the funds will be sent"},"developer_fee_percent":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?$","description":"Custom developer fee percentage for the Virtual Account"},"deposit_instructions":{"type":"object","oneOf":[{"title":"IBAN Account Details","properties":{"payment_rails":{"type":"array","description":"The available rails for deposits","items":{"type":"string","enum":["sepa"]}},"currency":{"type":"string","description":"The currency used for the deposit","enum":["eur"]},"bank_name":{"type":"string"},"bank_address":{"type":"string"},"account_holder_name":{"type":"string"},"iban":{"type":"object","properties":{"bic":{"type":"string"},"iban_number":{"type":"string"}}}}},{"title":"US Account Details","properties":{"payment_rails":{"type":"array","description":"The available rails for deposits","items":{"type":"string","enum":["ach","wire"]}},"currency":{"type":"string","description":"The currency used for the deposit","enum":["usd"]},"bank_name":{"type":"string"},"bank_address":{"type":"string"},"account_beneficiary_name":{"type":"string"},"account_beneficiary_address":{"type":"string"},"us":{"type":"object","properties":{"account_number":{"type":"string"},"routing_number":{"type":"string"}}}}},{"title":"International Wire Account Details","properties":{"payment_rails":{"type":"array","description":"The available rails for deposits","items":{"type":"string","enum":["swift"]}},"currency":{"type":"string","description":"The currency used for the deposit","enum":["usd"]},"bank_name":{"type":"string"},"bank_address":{"type":"string"},"account_beneficiary_name":{"type":"string"},"account_beneficiary_address":{"type":"string"},"international_wire":{"type":"object","properties":{"account_number":{"type":"string"},"routing_number":{"type":"string"},"bic":{"type":"string"}}}}}]}}}}}}
```
