Set the tenant's Dataprev codigoSolicitante
Stores (or corrects) the tenant’s Dataprev codigoSolicitante — the institution’s BACEN COMPE code, a 3-digit number (Numero 3 algarismos) in the range 001-999, required (Obrigatorio Sim) on nearly every rail operation. A COMPE code of 55 is published as 055; 000 is refused. It is PUBLIC, non-secret metadata held in Postgres beside the credential metadata; it is never written to the tenant secret store.
Authorizations
JWT bearer token issued by the identity provider.
Headers
Optional idempotency key. Sent again with the SAME body, the stored response is replayed and the code is stored once; sent again with a DIFFERENT body, the request is refused with 422 because the key was already spent on another intent. Absent, the request executes once, exactly as it always has.
"idem-1"
Body
The institution's BACEN COMPE code: exactly 3 digits, zero-padded (Manual 002 v1.15 §3.1.1 p.8), in the range 001-999 (Manual 001 §3.1.2 p.10). COMPE 55 is published as 055; 000 is not a code.
^(00[1-9]|0[1-9][0-9]|[1-9][0-9][0-9])$"341"
Response
OK
Whether a client certificate is stored for the tenant.
Whether OAuth2 client_credentials are stored for the tenant.
External rail the credentials belong to.
"dataprev"
Last-update timestamp (RFC 3339, UTC).
"2026-06-23T12:00:00Z"
SHA-256 hex fingerprint of the stored certificate (absent when none).
"3b1f...c0"
RFC 3339 cert expiry (UTC); absent when no cert is stored.
"2027-01-01T00:00:00Z"
Dataprev codigoSolicitante: the institution's BACEN COMPE code (3 digits, zero-padded, 001-999). Public, non-secret; absent when none is stored.
"341"
Credential revocation timestamp (RFC 3339, UTC); absent when credentials were never revoked.
"2026-07-14T15:30:00Z"

