From b5a0c72492800c7e999b87adfcfeabaacb4ecb97 Mon Sep 17 00:00:00 2001
From: Peter Bierma <zintensitydev@gmail.com>
Date: Sun, 9 Nov 2025 12:09:09 -0500
Subject: [PATCH] gh-141004: Document `PyExceptionInstance*` APIs (GH-141301)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
---
 Doc/c-api/exceptions.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst
index c58aa659e1b..5241533e112 100644
--- a/Doc/c-api/exceptions.rst
+++ b/Doc/c-api/exceptions.rst
@@ -788,6 +788,17 @@ Exception Classes
 Exception Objects
 =================
 
+.. c:function:: int PyExceptionInstance_Check(PyObject *op)
+
+   Return true if *op* is an instance of :class:`BaseException`, false
+   otherwise. This function always succeeds.
+
+
+.. c:macro:: PyExceptionInstance_Class(op)
+
+   Equivalent to :c:func:`Py_TYPE(op) <Py_TYPE>`.
+
+
 .. c:function:: PyObject* PyException_GetTraceback(PyObject *ex)
 
    Return the traceback associated with the exception as a new reference, as