---
title: "Edit a Virtual Reference Number"
method: PUT
path: "/virtual_reference_numbers/{uid}"
tags: ["Virtual Reference Numbers"]
---

# Edit a Virtual Reference Number

`PUT /virtual_reference_numbers/{uid}`

Updates the metadata of an existing Virtual Reference Number. This may include changes to labels, descriptions, or Instant Payment registration settings.

## Request body

- object
  - `external_uid` 0 — unresolved $ref
  - `name` string — A unique name, per pool, to identify the resource.

## Response `200`

The updated Virtual Reference Number resource is returned

- Schema — unresolved $ref

## Other responses

- `404` — The Virtual Reference Number is not found
- `422` — Failed to update Virtual Reference Number

## Changes

- **2026-08-21** `54f4fe726d8f` — 1 breaking, 1 info
  - the `allOf[subschema #1]/name` response's property type changed from no type to `string` for status `200`
  - added `#/components/schemas/0` to the `allOf[subschema #1]/external_uid` response property `allOf` list for the response status `200`

[Change history](https://skmtc.dev/newline53/apis/newline-platform-api/changes/virtual_reference_numbers/:uid/put.md)

---

[API](https://skmtc.dev/newline53/apis/newline-platform-api.md) · [All operations](https://skmtc.dev/newline53/apis/newline-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/newline53/newline-platform-api/revisions/54f4fe726d8f/schema)