Re-fija el schema major de una suscripción
Re-fija de forma acotada el schema_major de una suscripción — el único campo mutable. Envía exactamente un campo, schema_major: un entero >= 1 re-fija al topic versionado; null limpia la fijación para seguir la base. Cualquier otro campo, un valor fuera de rango o un cuerpo vacío se rechaza con 422 validation_error (los campos fuera de alcance se rechazan, no se ignoran). Un re-fijado no es un cambio de destino: no reinicia el estado de verificación ni devuelve ningún secreto. El éxito devuelve 200 sin cuerpo.
Autorizaciones
Un JWT bearer emitido por plugin-auth (lib-auth). La identidad del tenant se resuelve a partir de los claims validados del token; la superficie /v1 nunca lee un tenant del cuerpo, del path ni de la query. Los llamadores de máquina obtienen un token vía el flujo client-credentials de plugin-auth. La superficie /admin autoriza contra un scope de operador y no lleva contexto de tenant.
Encabezados
A client-chosen unique key that makes this mutation at-most-once. A mutation sent without it is rejected before any write with 400 missing_idempotency_key. Reusing the same key with an identical request replays the original response byte-for-byte (with X-Idempotency-Replayed: true); reusing it with a different request body returns 409 idempotency_conflict. To re-drive a corrected request, mint a new key.
Parámetros de ruta
The unique identifier of the subscription (UUIDv7).
Cuerpo
The narrow re-pin body. Exactly one field, schema_major: an integer >= 1 re-pins to the versioned topic; null clears the pin. Any other field or an empty body is rejected with 422 validation_error.
The schema major to pin, or null to follow the base topic. A value < 1 is rejected.
2
Respuesta
El re-fijado tuvo éxito (sin cuerpo).

