microsoft · dalemyers · Mar 10, 2026 · Mar 9, 2026
diff --git a/simple_ado/__init__.py b/simple_ado/__init__.py
@@ -181,7 +181,7 @@ def verify_access(self) -> bool:
         """
 
         request_url = (
-            self.http_client.api_endpoint(is_default_collection=False) + "/projects?api-version=6.0"
+            self.http_client.api_endpoint(is_default_collection=False) + "/projects?api-version=7.1"
         )
 
         try:
@@ -221,7 +221,7 @@ def create_pull_request(
         self.log.debug("Creating pull request")
 
         request_url = f"{self.http_client.api_endpoint(project_id=project_id)}/git/repositories/{repository_id}"
-        request_url += "/pullRequests?api-version=5.1"
+        request_url += "/pullRequests?api-version=7.1"
 
         body: dict[str, Any] = {
             "sourceRefName": _canonicalize_branch_name(source_branch),

diff --git a/simple_ado/audit.py b/simple_ado/audit.py
@@ -37,7 +37,7 @@ def get_actions(self, area_name: str | None = None) -> list[AuditActionInfo]:
 
         self.log.debug("Getting audit actions")
 
-        parameters = {"api-version": "6.0-preview.1"}
+        parameters = {"api-version": "7.1-preview.1"}
 
         if area_name:
             parameters["areaName"] = area_name
@@ -65,7 +65,7 @@ def query(
         :returns: The queried log
         """
 
-        parameters = {"api-version": "6.0-preview.1"}
+        parameters = {"api-version": "7.1-preview.1"}
 
         if start_time:
             parameters["startTime"] = start_time.strftime("%Y-%m-%dT%H:%M:%S.000Z")

diff --git a/simple_ado/builds.py b/simple_ado/builds.py
@@ -68,7 +68,7 @@ def queue_build(
         """
 
         request_url = (
-            f"{self.http_client.api_endpoint(project_id=project_id)}/build/builds?api-version=4.1"
+            f"{self.http_client.api_endpoint(project_id=project_id)}/build/builds?api-version=7.1"
         )
         variable_json = json.dumps(variables)
 
@@ -97,7 +97,7 @@ def build_info(self, *, project_id: str, build_id: int) -> ADOResponse:
 
         request_url = (
             self.http_client.api_endpoint(project_id=project_id)
-            + f"/build/builds/{build_id}?api-version=4.1"
+            + f"/build/builds/{build_id}?api-version=7.1"
         )
         response = self.http_client.get(request_url)
         return self.http_client.decode_response(response)
@@ -121,7 +121,7 @@ def get_builds(
         request_url = self.http_client.api_endpoint(project_id=project_id) + "/build/builds/?"
 
         parameters = {
-            "api-version": "4.1",
+            "api-version": "7.1",
         }
 
         if definitions:
@@ -180,7 +180,7 @@ def get_artifact_info(
 
         parameters = {
             "artifactName": artifact_name,
-            "api-version": "4.1",
+            "api-version": "7.1",
         }
 
         request_url = f"{self.http_client.api_endpoint(project_id=project_id)}/build/builds/{build_id}/artifacts?"
@@ -229,7 +229,7 @@ def download_artifact(
         parameters = {
             "artifactName": artifact_name,
             "$format": "zip",
-            "api-version": "4.1",
+            "api-version": "7.1",
         }
 
         request_url = f"{self.http_client.api_endpoint(project_id=project_id)}/build/builds/{build_id}/artifacts?"
@@ -423,7 +423,7 @@ def get_definitions(self, *, project_id: str) -> ADOResponse:
 
         request_url = (
             self.http_client.api_endpoint(project_id=project_id)
-            + "/build/definitions?api-version=6.0"
+            + "/build/definitions?api-version=7.1"
         )
 
         response = self.http_client.get(request_url)
@@ -441,7 +441,7 @@ def get_definition(self, *, project_id: str, definition_id: int) -> ADOResponse:
 
         request_url = (
             self.http_client.api_endpoint(project_id=project_id)
-            + f"/build/definitions/{definition_id}?api-version=6.0"
+            + f"/build/definitions/{definition_id}?api-version=7.1"
         )
 
         response = self.http_client.get(request_url)

diff --git a/simple_ado/endpoints.py b/simple_ado/endpoints.py
@@ -36,7 +36,7 @@ def get_endpoints(self, project_id: str, *, endpoint_type: str | None = None) ->
             self.http_client.api_endpoint(project_id=project_id) + "/serviceendpoint/endpoints?"
         )
 
-        parameters = {"api-version": "6.0-preview.4"}
+        parameters = {"api-version": "7.1"}
 
         if endpoint_type:
             parameters["type"] = endpoint_type
@@ -63,7 +63,7 @@ def get_usage_history(
             + f"/serviceendpoint/{endpoint_id}/executionhistory?"
         )
 
-        parameters: dict[str, Any] = {"api-version": "6.0-preview.1"}
+        parameters: dict[str, Any] = {"api-version": "7.1"}
 
         if not top or top < 50:
             parameters["top"] = top

diff --git a/simple_ado/git.py b/simple_ado/git.py
@@ -84,7 +84,7 @@ def all_repositories(self, project_id: str) -> ADOResponse:
         :returns: The ADO response with the data in it
         """
         self.log.debug("Getting repositories")
-        request_url = f"{self.http_client.api_endpoint(project_id=project_id)}/git/repositories/?api-version=1.0"
+        request_url = f"{self.http_client.api_endpoint(project_id=project_id)}/git/repositories/?api-version=7.1"
         response = self.http_client.get(request_url)
         response_data = self.http_client.decode_response(response)
         return self.http_client.extract_value(response_data)
@@ -100,7 +100,7 @@ def get_repository(self, *, project_id: str, repository_id: str) -> ADOResponse:
         self.log.debug(f"Getting repository {repository_id}")
         request_url = (
             f"{self.http_client.api_endpoint(project_id=project_id)}/git/"
-            + f"repositories/{repository_id}?api-version=6.0"
+            + f"repositories/{repository_id}?api-version=7.1"
         )
         response = self.http_client.get(request_url)
         return self.http_client.decode_response(response)
@@ -124,7 +124,7 @@ def get_status(self, *, sha: str, project_id: str, repository_id: str) -> ADORes
 
         request_url = (
             self.http_client.api_endpoint(project_id=project_id)
-            + f"/git/repositories/{repository_id}/commits/{sha}/statuses?api-version=2.1"
+            + f"/git/repositories/{repository_id}/commits/{sha}/statuses?api-version=7.1"
         )
 
         response = self.http_client.get(request_url)
@@ -171,7 +171,7 @@ def set_status(
             self.http_client.api_endpoint(project_id=project_id)
             + f"/git/repositories/{repository_id}/commits/{sha}/"
         )
-        request_url += "statuses?api-version=2.1"
+        request_url += "statuses?api-version=7.1"
 
         body = {
             "state": state.value,
@@ -215,7 +215,7 @@ def diff_between_commits(
 
         while True:
             parameters = {
-                "api-version": "5.1",
+                "api-version": "7.1",
                 "baseVersionType": "commit",
                 "baseVersion": base_commit,
                 "targetVersionType": "commit",
@@ -272,7 +272,7 @@ def download_zip(
             "versionDescriptor[version]": branch,
             "resolveLfs": "true",
             "$format": "zip",
-            "api-version": "5.0-preview.1",
+            "api-version": "7.1",
         }
 
         request_url += urllib.parse.urlencode(parameters)
@@ -381,7 +381,7 @@ def get_refs(
         if len(parameters) > 0:
             request_url += "&"
 
-        request_url += "api-version=5.0"
+        request_url += "api-version=7.1"
 
         response = self.http_client.get(request_url)
         response_data = self.http_client.decode_response(response)
@@ -406,7 +406,7 @@ def get_stats_for_branch(
         self.log.debug("Getting stats")
 
         request_url = f"{self.http_client.api_endpoint(project_id=project_id)}/git/repositories/{repository_id}"
-        request_url += f"/stats/branches?name={branch_name}&api-version=6.0"
+        request_url += f"/stats/branches?name={branch_name}&api-version=7.1"
 
         response = self.http_client.get(request_url)
         return self.http_client.decode_response(response)
@@ -435,7 +435,7 @@ def get_commit(
         self.log.debug(f"Getting commit: {commit_id}")
 
         request_url = f"{self.http_client.api_endpoint(project_id=project_id)}/git/repositories/{repository_id}"
-        request_url += f"/commits/{commit_id}?api-version=5.0"
+        request_url += f"/commits/{commit_id}?api-version=7.1"
 
         if change_count:
             request_url += f"&changeCount={change_count}"
@@ -462,7 +462,7 @@ def update_refs(
         self.log.debug("Updating references")
 
         request_url = f"{self.http_client.api_endpoint(project_id=project_id)}/git/repositories/{repository_id}"
-        request_url += "/refs?api-version=5.0"
+        request_url += "/refs?api-version=7.1"
 
         data = [update.json_data() for update in updates]
 
@@ -551,7 +551,7 @@ def get_item(
 
         request_url = f"{self.http_client.api_endpoint(project_id=project_id)}/git/repositories/{repository_id}/items?"
 
-        parameters: dict[str, Any] = {"api-version": "5.1", "$format": "json"}
+        parameters: dict[str, Any] = {"api-version": "7.1", "$format": "json"}
 
         if not scope_path and not path:
             raise ADOException("Either path or scope_path must be set")
@@ -752,7 +752,7 @@ def get_blob(
         request_url += f"/git/repositories/{repository_id}/blobs/{blob_id}?"
 
         parameters: dict[str, Any] = {
-            "api-version": "5.1",
+            "api-version": "7.1",
         }
 
         if blob_format is not None:
@@ -806,7 +806,7 @@ def get_blobs(
         request_url = self.http_client.api_endpoint(
             is_default_collection=False, project_id=project_id
         )
-        request_url += f"/git/repositories/{repository_id}/blobs?api-version=5.1"
+        request_url += f"/git/repositories/{repository_id}/blobs?api-version=7.1"
 
         if os.path.exists(output_path):
             raise FileExistsError("The output path already exists")

diff --git a/simple_ado/graph.py b/simple_ado/graph.py
@@ -30,7 +30,7 @@ def get_scope_descriptors(self, storage_key: str) -> ADOResponse:
         """
 
         request_url = f"{self.http_client.graph_endpoint()}/graph/descriptors/{storage_key}"
-        request_url += "/?api-version=6.0-preview.1"
+        request_url += "/?api-version=7.1-preview.1"
         response = self.http_client.get(request_url)
         return self.http_client.decode_response(response)
 
@@ -43,7 +43,7 @@ def get_storage_key(self, subject_descriptor: str) -> ADOResponse:
         """
 
         request_url = f"{self.http_client.graph_endpoint()}/graph/storagekeys/{subject_descriptor}"
-        request_url += "/?api-version=6.0-preview.1"
+        request_url += "/?api-version=7.1-preview.1"
         response = self.http_client.get(request_url)
         return self.http_client.decode_response(response)
 
@@ -56,7 +56,7 @@ def lookup_subjects(self, subject_descriptors: list[str]) -> list[Any]:
         """
 
         request_url = f"{self.http_client.graph_endpoint()}/graph/subjectlookup"
-        request_url += "/?api-version=6.0-preview.1"
+        request_url += "/?api-version=7.1-preview.1"
 
         data = {"lookupKeys": [{"descriptor": descriptor} for descriptor in subject_descriptors]}
 
@@ -72,7 +72,7 @@ def list_groups(self, *, scope_descriptor: str | None = None) -> list[Any]:
         :returns: The ADO response with the data in it
         """
 
-        request_url = f"{self.http_client.graph_endpoint()}/graph/groups?api-version=5.1-preview.1"
+        request_url = f"{self.http_client.graph_endpoint()}/graph/groups?api-version=7.1-preview.1"
 
         if scope_descriptor:
             request_url += f"&scopeDescriptor={scope_descriptor}"
@@ -106,7 +106,7 @@ def get_group(self, descriptor: str) -> ADOResponse:
         """
 
         request_url = f"{self.http_client.graph_endpoint()}/graph/groups"
-        request_url += f"/{descriptor}?api-version=5.1-preview.1"
+        request_url += f"/{descriptor}?api-version=7.1-preview.1"
         response = self.http_client.get(request_url)
         return self.http_client.decode_response(response)
 
@@ -119,7 +119,7 @@ def get_user(self, descriptor: str) -> ADOResponse:
         """
 
         request_url = f"{self.http_client.graph_endpoint()}/graph/users"
-        request_url += f"/{descriptor}?api-version=5.1-preview.1"
+        request_url += f"/{descriptor}?api-version=7.1-preview.1"
         response = self.http_client.get(request_url)
         return self.http_client.decode_response(response)
 
@@ -130,7 +130,7 @@ def get_users(self) -> ADOResponse:
         """
 
         request_url = f"{self.http_client.graph_endpoint()}/graph/users"
-        request_url += "?api-version=6.0-preview.1"
+        request_url += "?api-version=7.1-preview.1"
         response = self.http_client.get(request_url)
         return self.http_client.decode_response(response)
 

diff --git a/simple_ado/identities.py b/simple_ado/identities.py
@@ -36,7 +36,7 @@ def search(self, identity: str) -> list[dict[str, Any]]:
 
         request_url = self.http_client.graph_endpoint()
         request_url += f"/identities?searchFilter=General&filterValue={identity}"
-        request_url += "&queryMembership=None&api-version=6.0"
+        request_url += "&queryMembership=None&api-version=7.1"
 
         response = self.http_client.get(request_url)
         response_data = self.http_client.decode_response(response)

diff --git a/simple_ado/pipelines.py b/simple_ado/pipelines.py
@@ -136,7 +136,7 @@ def get_top_ten_thousand_runs(self, *, project_id: str, pipeline_id: int) -> ADO
 
         request_url = (
             self.http_client.api_endpoint(project_id=project_id)
-            + f"/pipelines/{pipeline_id}/runs?api-version=6.0-preview.1"
+            + f"/pipelines/{pipeline_id}/runs?api-version=7.1"
         )
 
         response = self.http_client.get(request_url)
@@ -155,7 +155,7 @@ def get_run(self, *, project_id: str, pipeline_id: int, run_id: int) -> ADORespo
 
         request_url = (
             self.http_client.api_endpoint(project_id=project_id)
-            + f"/pipelines/{pipeline_id}/runs/{run_id}?api-version=6.0-preview.1"
+            + f"/pipelines/{pipeline_id}/runs/{run_id}?api-version=7.1"
         )
 
         response = self.http_client.get(request_url)
@@ -191,7 +191,7 @@ def run_pipeline(
 
         request_url = (
             self.http_client.api_endpoint(project_id=project_id)
-            + f"/pipelines/{pipeline_id}/runs?api-version=6.1-preview.1"
+            + f"/pipelines/{pipeline_id}/runs?api-version=7.1"
         )
 
         if pipeline_version:

diff --git a/simple_ado/pools.py b/simple_ado/pools.py
@@ -50,7 +50,7 @@ def get_pools(
         request_url = self.http_client.api_endpoint(is_default_collection=False)
         request_url += "/distributedtask/pools?"
 
-        parameters = {"api-version": "5.1"}
+        parameters = {"api-version": "7.1"}
 
         if pool_name:
             parameters["poolName"] = pool_name
@@ -91,7 +91,7 @@ def get_agents(
             "includeCapabilities": include_capabilities,
             "includeAssignedRequest": include_assigned_request,
             "includeLastCompletedRequest": include_last_completed_request,
-            "api-version": "5.1",
+            "api-version": "7.1",
         }
 
         if agent_name:
@@ -113,7 +113,7 @@ def get_agent(self, *, pool_id: int, agent_id: int) -> ADOResponse:
         """
 
         request_url = self.http_client.api_endpoint(is_default_collection=False)
-        request_url += f"/distributedtask/pools/{pool_id}/agents/{agent_id}?api-version=5.1"
+        request_url += f"/distributedtask/pools/{pool_id}/agents/{agent_id}?api-version=7.1"
 
         response = self.http_client.get(request_url)
         return self.http_client.decode_response(response)
@@ -131,7 +131,7 @@ def update_agent(
         """
 
         request_url = self.http_client.api_endpoint(is_default_collection=False)
-        request_url += f"/distributedtask/pools/{pool_id}/agents/{agent_id}?api-version=5.1"
+        request_url += f"/distributedtask/pools/{pool_id}/agents/{agent_id}?api-version=7.1"
 
         response = self.http_client.patch(request_url, json_data=agent_data)
         return self.http_client.decode_response(response)
@@ -164,7 +164,7 @@ def update_agent_capabilities(
 
         request_url = self.http_client.api_endpoint(is_default_collection=False)
         request_url += (
-            f"/distributedtask/pools/{pool_id}/agents/{agent_id}/usercapabilities?api-version=5.1"
+            f"/distributedtask/pools/{pool_id}/agents/{agent_id}/usercapabilities?api-version=7.1"
         )
 
         response = self.http_client.put(request_url, json_data=capabilities)