Skip to main content
POST
Rotacionar certificado ICP-Brasil

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency
string

Idempotency key (primary).

X-Idempotency-Key
string

Idempotency key (legacy alias for X-Idempotency).

X-TTL
string

Idempotency key TTL in seconds (overrides the configured default).

Corpo

application/json
certificateRef
string
obrigatório

Operator-supplied reference to the new certificate material (filesystem path or secrets-manager URI), validated against the configured cert directory before any read.

Required string length: 1 - 2048
Exemplo:

"/etc/lerian/certs/2026-q2/icp-brasil.crt"

privateKeyRef
string
obrigatório

Operator-supplied reference to the new private-key material (filesystem path or secrets-manager URI), validated against the configured cert directory before any read.

Required string length: 1 - 2048
Exemplo:

"/etc/lerian/certs/2026-q2/icp-brasil.key"

reason
string

Optional operator rationale recorded in the audit evidence (max 512 chars).

Maximum string length: 512
Exemplo:

"Quarterly rotation per ICP-Brasil policy"

Resposta

OK

auditId
string<uuid>
obrigatório

UUID of the audit record written for this rotation.

Exemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

certificate
object
obrigatório

State of the certificate after the rotation hot-reload.

correlationId
string
obrigatório

Request-scoped correlation identifier echoing X-Request-ID, for pivoting from response to trace.

Exemplo:

"req-7a3f9c2e"

readiness
object

Optional post-rotation readiness summary; omitted when readiness lookup is unavailable.