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

# PUT /mode/{subject}

`PUT /mode/{subject}`

## Request

- The document declares no server URL.
- Auth: none declared

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

## Changes

- **2026-05-08** (v8) `9e42a44352e7`: 12 breaking
  - removed the enum value `IMPORT` of the request property `mode` (media type: application/json)
  - removed the enum value `IMPORT` of the request property `mode` (media type: application/octet-stream)
  - removed the enum value `IMPORT` of the request property `mode` (media type: application/vnd.schemaregistry.v1+json)
  - removed the enum value `IMPORT` of the request property `mode` (media type: application/vnd.schemaregistry+json)
  - …8 more
- **2026-02-11** (v8) `d015d4d95cbe`: 4 breaking, 12 info
  - request property `mode` was restricted to a list of enum values (media type: application/json)
  - request property `mode` was restricted to a list of enum values (media type: application/octet-stream)
  - request property `mode` was restricted to a list of enum values (media type: application/vnd.schemaregistry.v1+json)
  - request property `mode` was restricted to a list of enum values (media type: application/vnd.schemaregistry+json)
  - …12 more

[Operation history](https://skmtc.dev/apicurio/apis/apicurio-registry-confluent-compatibility-api/changes/mode/:subject/put.md)

---

[API](https://skmtc.dev/apicurio/apis/apicurio-registry-confluent-compatibility-api.md) - [All operations](https://skmtc.dev/apicurio/apis/apicurio-registry-confluent-compatibility-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apicurio/apis/apicurio-registry-confluent-compatibility-api/revisions/a2f9ca447c9b?raw)