Hanzo
OpenapiIam

Adds a signing certificate your applications can verify tokens against — the…

Adds a signing certificate your applications can verify tokens against — the call you make to stage the next one before a rotation.

POST /v1/iam/certs

Addresshttps://api.hanzo.ai/v1/iam/certs
MethodPOST
Operationpost_iam_certs
AuthAuthorization: Bearer $HANZO_API_KEY

Adds a signing certificate your applications can verify tokens against — the call you make to stage the next one before a rotation. A name already used in your organization is refused.

It registers the certificate's IDENTITY: its name (which is the JWKS kid), its algorithm, its expiry. Key material does not travel this way and cannot: the private key is not part of the Cert's JSON, so it is neither served here nor accepted here. It is supplied to the process by the deployment, under the name registered here (internal/keyring). Staging a rotation is therefore two halves — this call names the key, and the deployment provides it.

Request

20 fields, body application/json (required).

FieldInTypeRequiredDescription
accessKeybodystring
accessSecretbodystring
accountbodystring
bitSizebodyinteger
certificatebodystring
createdAtbodystring (date-time)
createdTimebodystring
cryptoAlgorithmbodystring
deletedbodyboolean
displayNamebodystring
domainExpireTimebodystring
expireInYearsbodyinteger
expireTimebodystring
idbodystring
namebodystring
ownerbodystring
providerbodystring
scopebodystring
typebodystring
updatedAtbodystring (date-time)

Response

StatusBodyMeaning
200iam.Certok

200 body — 20 fields.

FieldInTypeAlwaysDescription
accessKeybodystring
accessSecretbodystring
accountbodystring
bitSizebodyinteger
certificatebodystring
createdAtbodystring (date-time)
createdTimebodystring
cryptoAlgorithmbodystring
deletedbodyboolean
displayNamebodystring
domainExpireTimebodystring
expireInYearsbodyinteger
expireTimebodystring
idbodystring
namebodystring
ownerbodystring
providerbodystring
scopebodystring
typebodystring
updatedAtbodystring (date-time)

Failure carries the platform error shape — see Errors.

Examples

hanzo iam certs create

IAM API · All Hanzo APIs · Interactive reference

How is this guide?

On this page