POST/organization/certificates/deactivate

Deactivate organization certificates

Deactivates organization-level certificates in a single request. Supply between 1 and 10 certificate IDs; the operation is atomic and idempotent.

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

1 body field

The certificate deactivation payload.

certificate_idsarray<string>required
The IDs of the certificates to deactivate. Supply between 1 and 10 IDs.

6 status codes
200Returns the deactivation result and an array of organization certificate objects with their current active status.
objectstringrequired
The organization certificate deactivation result type.
Allowed:organization.certificate.deactivation
dataarray<object>required
400Returned when the request parameters are invalid or the requested operation cannot be performed.
errorobjectrequired
403Returned when the caller does not have permission to deactivate organization certificates.
errorobjectrequired
Details about the permission error.
404Returned when a certificate is not found in the organization.
errorobjectrequired
429Returned when the request exceeds a rate limit.
errorobjectrequired
500Returned when a server error prevents the certificate update.
errorobjectrequired

Error handling

A 400 is returned when the request parameters are invalid or the operation cannot be performed. A 403 is returned when the authenticated user lacks permission to deactivate certificates. A 404 is returned when a certificate is not found in the organization. A 429 is returned when the request exceeds a rate limit. A 500 is returned when a server error prevents the certificate update. certificate_ids must contain between 1 and 10 certificate IDs.