---
title: "Update merchant status"
method: PUT
path: "/v1/merchants/{merchantId}/workflow/status"
tags: ["Merchant"]
---

# Update merchant status

`PUT /v1/merchants/{merchantId}/workflow/status`

## Request

- Base URL: `https://sandbox.pismolabs.io/merchants`
- URL: `https://sandbox.pismolabs.io/merchants/v1/merchants/{merchantId}/workflow/status`
- Auth: HTTP bearer

Update merchant status using the merchant ID.

To find all available merchant status transitions, use [List status transitions](ref:liststatustransitions).

This endpoint generates a [Merchant updated](https://developers.pismo.io/events/docs/merchants-merchant-updated-1) event.

## Path parameters

- `merchantId` integer, required

## Headers

- `Content-Type` string
- `Authorization` string

## Request body

- object
  - `status` string, required: Merchant status. This is a string, not an enum, so any string value is allowed, but the most commonly used values are: 'ACTIVE', 'ANALYSING', 'APPROVED', 'CANCELLED', 'PENDING', 'REJECTED'
  - `notes` string: Notes about the operation. <b>Note</b>: This field is <b>deprecated</b> and scheduled for removal.

## Response `200`

OK

## Other responses

- `400`: Bad Request
- `401`: Access token is missing or invalid
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/seller-management-merchants.md) - [All operations](https://skmtc.dev/pismo/apis/seller-management-merchants/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/seller-management-merchants/revisions/f0c2e31fbbc0?raw)