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

# merchants.rename

`POST /capabilities/merchants.rename`

## Request

- Base URL: `https://developer.api.receiptor.ai/v1`
- URL: `https://developer.api.receiptor.ai/v1/capabilities/merchants.rename`
- Auth: one of:
  - API key in header `x-receiptor-api-key`
  - HTTP bearer

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.dev/receiptor/apis/receiptor-ai-api.md) - [All operations](https://skmtc.dev/receiptor/apis/receiptor-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/receiptor/apis/receiptor-ai-api/revisions/a2d8aea5337a?raw)