From 2064faba96fe63ade9e870436d705c3495ba92c2 Mon Sep 17 00:00:00 2001
From: Tim Jenness <tjenness@lsst.org>
Date: Tue, 3 Dec 2024 16:07:20 -0700
Subject: [PATCH] Add news fragment

---
 doc/changes/DM-47325.feature.rst | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 doc/changes/DM-47325.feature.rst

diff --git a/doc/changes/DM-47325.feature.rst b/doc/changes/DM-47325.feature.rst
new file mode 100644
index 0000000000..3fe2ac51b8
--- /dev/null
+++ b/doc/changes/DM-47325.feature.rst
@@ -0,0 +1,5 @@
+Added two new APIs for handling Butler dataset URIs.
+``Butler.parse_dataset_uri`` parses a URI and returns the butler repository label and associated UUID.
+``Butler.get_dataset_from_uri`` will parse a URI and attempt to retrieve the ``DatasetRef``.
+URIs should be of the form IVOA identifiers as described in `DMTN-302 <https://dmtn-302.lsst.io>`_.
+Deprecated ``butler://`` URIs are still supported but should not be used in new systems.