Repinar o schema major de uma assinatura
Repina de forma restrita o schema_major de uma assinatura — o único campo mutável. Envie exatamente um campo, schema_major: um inteiro >= 1 repina para o tópico versionado; null remove o pin para seguir o tópico base. Qualquer outro campo, um valor fora do intervalo ou um corpo vazio é rejeitado com 422 validation_error (campos fora de escopo são rejeitados, não ignorados). Um repin não é uma mudança de destino: ele não reinicia o estado de verificação e não devolve nenhum segredo. O sucesso retorna 200 sem corpo.
Autorizações
Um JWT bearer emitido pelo plugin-auth (lib-auth). A identidade do tenant é resolvida a partir das claims validadas do token; a superfície /v1 nunca lê um tenant do corpo, do path ou da query. Chamadores de máquina obtêm um token via o fluxo client-credentials do plugin-auth. A superfície /admin autoriza contra um escopo de operador e não carrega contexto de tenant.
Cabeçalhos
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 caminho
The unique identifier of the subscription (UUIDv7).
Corpo
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
Resposta
O repin foi bem-sucedido (sem corpo).

