Develop

[gem-cp]

This pull request makes significant improvements and clarifications to the OpenAPI specifications for both the Notification Service RS endpoint and the Zeta Guard Admin OOB interface. The main focus is on enhancing documentation, clarifying lifecycle and audit concepts, and improving operator guidance. The changes also introduce support for idempotent notification submissions and expand descriptions for API parameters and objects.

Notification Service RS Endpoint

• Added detailed documentation on the notification history feature, clarifying that history is implemented and exposed by the Notification Service itself, and specifying when and how it is activated (A_29973, A_29974, A_29975–A_29978). Also clarified the retention and privacy requirements for notification identifiers (A_29988).
• Updated references to requirements for identifier storage, replacing A_NS_DEPLOY_01 with A_29957.
• Introduced support for idempotent retransmission of notification submissions using the Idempotency-Key header, including new documentation and schema for this header (A_29988, A_29992).

Zeta Guard Admin OOB Interface

• Improved and clarified lifecycle documentation, including a revised state diagram and more precise descriptions of veto, approval, and dual control. Removed draft standards section and enhanced endpoint descriptions for better operator understanding. [1] [2] [3] [4] [5] [6] [7] [8]
• Expanded and clarified descriptions for parameters, request/response fields, and audit trail filtering, including new descriptions for query parameters and improved documentation for operator actions and audit logging. [1] [2] [3] [4] [5] [6]
• Added or improved descriptions for OpenAPI schema components, including DeletionStatus, OobProof, OperatorRef, and DeletionRequest, to clarify their roles and required fields, and to ensure auditability and traceability of operator actions.

These changes greatly improve the clarity, auditability, and operational guidance for both APIs, making them easier for implementers and operators to understand and use.

• Notification Service RS Endpoint:

  • Clarified notification history implementation and privacy/retention requirements.
  • Updated requirement references for identifier storage.
  • Added idempotent submission support via Idempotency-Key header.

• Zeta Guard Admin OOB Interface:

  • Enhanced lifecycle, veto, and dual control documentation; improved endpoint and parameter descriptions. [1] [2] [3] [4] [5] [6] [7] [8]
  • Expanded OpenAPI schema component descriptions for better auditability and operator guidance. [1] [2] [3] [4] [5] [6] [7]