---
title: "merchants.rename"
method: POST
path: "/capabilities/merchants.rename"
tags: ["Capabilities"]
---

# merchants.rename

`POST /capabilities/merchants.rename`

Rename one merchant to a preferred merchant name, optionally updating website, tax ID, and address.

## Request body

- object
  - `currentMerchantName` string, required — Current merchant name to rename
  - `newMerchantName` string, required — Preferred merchant name to apply
  - `merchantWebsite` string — Preferred merchant website URL
  - `merchantTaxId` string — Preferred merchant tax ID or VAT number
  - `merchantAddress` string — Preferred merchant address

## Response `200`

Successful response

- object
  - `success` boolean
  - `code` integer
  - `data` object
    - `result` object — Capability-specific result

## Other responses

- `400` — Invalid input
- `401` — Authentication required
- `404` — Resource not found

---

[API](https://skmtc.net/receiptor/apis/receiptor-ai-api.md) · [All operations](https://skmtc.net/receiptor/apis/receiptor-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/receiptor/receiptor-ai-api/versions/da17f0eb65a2/schema)