diff --git a/include/crm/common/roles.h b/include/crm/common/roles.h
index a804550b13..be2e12687b 100644
--- a/include/crm/common/roles.h
+++ b/include/crm/common/roles.h
@@ -1,49 +1,52 @@
 /*
  * Copyright 2004-2023 the Pacemaker project contributors
  *
  * The version control history for this file may have further details.
  *
  * This source code is licensed under the GNU Lesser General Public License
  * version 2.1 or later (LGPLv2.1+) WITHOUT ANY WARRANTY.
  */
 
 #ifndef PCMK__CRM_COMMON_ROLES__H
 #  define PCMK__CRM_COMMON_ROLES__H
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
 /*!
  * \file
  * \brief Scheduler API for resource roles
  * \ingroup core
  */
 
 /*!
  * Possible roles that a resource can be in
  * (order matters; values can be compared with less than and greater than)
  */
 enum rsc_role_e {
     pcmk_role_unknown       = 0, //!< Resource role is unknown
 
+#if !defined(PCMK_ALLOW_DEPRECATED) || (PCMK_ALLOW_DEPRECATED == 1)
+    //! \deprecated Use pcmk_role_unknown instead
     RSC_ROLE_UNKNOWN        = pcmk_role_unknown,
+#endif
     RSC_ROLE_STOPPED    = 1,
     RSC_ROLE_STARTED    = 2,
     RSC_ROLE_UNPROMOTED = 3,
     RSC_ROLE_PROMOTED   = 4,
 
 #if !defined(PCMK_ALLOW_DEPRECATED) || (PCMK_ALLOW_DEPRECATED == 1)
     //! \deprecated Use RSC_ROLE_UNPROMOTED instead
     RSC_ROLE_SLAVE      = RSC_ROLE_UNPROMOTED,
 
     //! \deprecated Use RSC_ROLE_PROMOTED instead
     RSC_ROLE_MASTER     = RSC_ROLE_PROMOTED,
 #endif
 };
 
 #ifdef __cplusplus
 }
 #endif
 
 #endif // PCMK__CRM_COMMON_ROLES__H