POST/organization/certificates

Upload certificate

Upload a certificate to the organization. This does not automatically activate the certificate.

Organizations can upload up to 50 certificates.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 body fields

The certificate upload payload.

namestringoptional
An optional name for the certificate
certificatestringrequired
The certificate content in PEM format

4 status codes
200Certificate uploaded successfully.
objectstringrequired
The object type. - If creating, updating, or getting a specific certificate, the object type is `certificate`. - If listing, activating, or deactivating certificates for the organization, the object type is `organization.certificate`. - If listing, activating, or deactivating certificates for a project, the object type is `organization.project.certificate`.
Allowed:certificateorganization.certificateorganization.project.certificate
idstringrequired
The identifier, which can be referenced in API endpoints
namestringrequired
The name of the certificate.
created_atintegerrequired
The Unix timestamp (in seconds) of when the certificate was uploaded.
certificate_detailsobjectrequired
activebooleanoptional
Whether the certificate is currently active at the specified scope. Not returned when getting details for a specific certificate.
400The request parameters are invalid or the requested operation cannot be performed.
errorobjectrequired
403The caller does not have permission to perform this operation.
errorobjectrequired
Details about the permission error.
429The request was rejected because a rate limit was exceeded.
errorobjectrequired

Error handling

A 400 is returned: The request parameters are invalid or the requested operation cannot be performed. A 403 is returned: The caller does not have permission to perform this operation. A 429 is returned: The request was rejected because a rate limit was exceeded.