---
title: "Move a named ref"
method: PUT
path: "/v1/refs/{name}"
---

# Move a named ref

`PUT /v1/refs/{name}`

## Request

- Base URL: `https://store.example.com`
- URL: `https://store.example.com/v1/refs/{name}`
- Auth: HTTP bearer

Requires writer. expected_root is "" only when creating the ref.

## Request body

- object
  - `root` string, required
  - `expected_root` string, required

## Response `200`

Updated

- object

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `415`: Error

---

[API](https://skmtc.dev/aviansuite/apis/stellar-jay-http-api.md) · [All operations](https://skmtc.dev/aviansuite/apis/stellar-jay-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aviansuite/apis/stellar-jay-http-api/revisions/1da9767d0a43?raw)