---
title: "PUT /mode/{subject}"
method: PUT
path: "/mode/{subject}"
tags: ["Mode"]
---

# PUT /mode/{subject}

`PUT /mode/{subject}`

Updates the subject-level mode. This is allowed only if Schema Registry was started with mode.mutability=true.

## Path parameters

- `subject` string, required

## Query parameters

- `force` boolean

## Headers

- `X-Registry-GroupId` string

## Request body

- ModeUpdateRequest
  - `mode` string, required — The new global mode to set.

## Response `200`

Returns the updated subject mode.

- ModeUpdateResponse
  - `mode` 'READWRITE' | 'READONLY' | 'IMPORT', required — Current operating mode of the registry.

## Other responses

- `422` — Error returned by the Schema Registry API
- `500` — Error returned by the Schema Registry API

---

[API](https://skmtc.net/apicurio/apis/apicurio-registry-confluent-compatibility-api.md) · [All operations](https://skmtc.net/apicurio/apis/apicurio-registry-confluent-compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apicurio/apicurio-registry-confluent-compatibility-api/versions/933e587f2d85/schema)