Skip to main content
DELETE
/
certificates
/
{id}
Delete Certificate
curl --request DELETE \
  --url https://api.example.com/certificates/{id}

​
Request

curl -X DELETE https://api.certwatch.app/v1/certificates/cert_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

ParameterTypeDescription
idstringCertificate ID (e.g., cert_abc123)

​
Response

{
  "data": {
    "id": "cert_abc123",
    "deleted": true
  },
  "meta": {
    "requestId": "req_xyz789"
  }
}

​
Effects

Deleting a certificate:
  • Immediately stops monitoring for the domain
  • Removes all alert configurations
  • Clears notification history for this certificate
  • Cannot be undone
This action is permanent. Consider disabling alerts instead if you may want to monitor this domain again.

​
Errors

​
404 Not Found

{
  "error": {
    "code": "certificate_not_found",
    "message": "Certificate not found"
  }
}

​
401 Unauthorized

{
  "error": {
    "code": "invalid_api_key",
    "message": "The provided API key is invalid"
  }
}

​
403 Forbidden

{
  "error": {
    "code": "permission_denied",
    "message": "You do not have permission to delete this certificate"
  }
}