Sign in

v1

latestOpenAPI 3.0.2Apache 2.02026-07-174217115.5 KB
Mode

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

put/mode/{subject}

Path parameters

subjectstring required

Name of the subject.

Query parameters

forceboolean

If true, forces the mode change even if schemas already exist. Useful in disaster recovery scenarios.

Headers

X-Registry-GroupIdstring

Group id in Apicurio Registry.

Request body

modestring required

The new global mode to set.

Example request

{
  "mode": "IMPORT"
}

Response

Returns the updated subject mode.

mode'READWRITE' | 'READONLY' | 'IMPORT' required

Current operating mode of the registry.

Example response

{
  "mode": "READWRITE"
}