added basic REST samples that don't require client or lang - UUF

Author: chcomley

docs/integrate/get-started/rest/samples.md

@@ -2,13 +2,14 @@
 title: REST API samples
 description: REST API samples for Azure DevOps, including personal access tokens (PATs).
 ms.assetid: 9E17A266-051F-403F-A285-7F21D9CC52F0
+ai-usage: ai-assisted
 ms.subservice: azure-devops-ecosystem
 ms.topic: conceptual
 ms.custom: devx-track-dotnet
 monikerRange: '<= azure-devops'
 ms.author: chcomley
 author: chcomley
-ms.date: 03/21/2025
+ms.date: 06/10/2025
 ---
 
 # REST API samples for Azure DevOps
@@ -17,26 +18,31 @@ ms.date: 03/21/2025
 
 Most samples in this article use personal access tokens (PATs). While PATs are a compact example for authentication, we don't recommend using them for production applications. There are many other authentication mechanisms available, including Microsoft Authentication Library, OAuth, and Session tokens. For more information to gauge which is best suited for your scenario, see [Authentication guidance](../authentication/authentication-guidance.md).
 
-For more information, see [Azure DevOps Services REST API Reference](/rest/api/azure/devops/?view=azure-devops-rest-7.2&preserve-view=true) and [Get started with REST APIs](../../how-to/call-rest-api.md).
+For more information, see [Azure DevOps REST API Reference](/rest/api/azure/devops/?view=azure-devops-rest-7.2&preserve-view=true) and [Get started with REST APIs](../../how-to/call-rest-api.md).
 
-## Personal access tokens
+## Authentication
 
-Authenticate with Azure DevOps when you use the REST APIs or .NET Libraries. 
+Authenticate with Azure DevOps when using the REST APIs or .NET Libraries by following these steps:
 
-Get started with these samples and [create a PAT](../../../organizations/accounts/use-personal-access-tokens-to-authenticate.md).
+- **Create a PAT:**  
+  Start with these samples and [create a personal access token (PAT)](../../../organizations/accounts/use-personal-access-tokens-to-authenticate.md).
 
-> [!NOTE]
-> We don't recommend using PATs. For more secure authentication mechanisms, see [Authentication guidance](../authentication/authentication-guidance.md).
+- **Preferred Microsoft Entra authentication:**  
+  [!INCLUDE [use-microsoft-entra-reduce-pats](../../../includes/use-microsoft-entra-reduce-pats.md)]
 
-To provide the PAT through an HTTP header, first convert it to a Base64 string. The following example shows how to convert to Base64 using C#. You can provide the resulting string as an HTTP header in the following format:
+- **Use Basic Authentication with a PAT:**  
+  1. Convert your PAT to a Base64-encoded string in the format `username:PAT` (the username can be empty).
+  2. Add the encoded string to the `Authorization` HTTP header.
 
-``
-Authorization: Basic BASE64USERNAME:PATSTRING
-``
+   **Example using Basic Authentication with curl:**
 
-## REST API
+   ```bash
+   curl -u :{yourPAT} https://dev.azure.com/{organization}/_apis/projects?api-version=7.2-preview.1
+   ```
 
-See the following example of getting a list of projects for your organization via REST API. 
+## GET request samples
+
+The following C# and curl requests return a JSON response containing the list of all projects in a specified organization:
 
 ```cs
 using System.Net.Http;
@@ -69,7 +75,40 @@ using (var client = new HttpClient())
         //var value = response.Content.ReadAsStringAsync().Result;
     }   
 }
+```
+
+
+```curl 
+-u username:PAT https://dev.azure.com/{organization}/_apis/projects?api-version=6.0
+```
+
+## POST request samples
+
+The following curl request creates a new work item of the "Task" type in a specified project:
+
+```curl 
+-u username:PAT -X POST -H "Content-Type: application/json" \
+-d '{"fields": {"System.Title": "New Work Item"}}' \
+https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/$Task?api-version=6.0
+```
+
+## PUT request samples
+
+The following curl request updates an existing work item by changing its state to "In Progress":
+
+```curl
+ -u username:PAT -X PATCH -H "Content-Type: application/json-patch+json" \
+-d '[{"op": "add", "path": "/fields/System.State", "value": "In Progress"}]' \
+https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?api-version=6.0
+```
+
+## DELETE request samples
 
+The following curl request deletes an existing work item from a specified project:
+
+```curl 
+-u username:PAT -X DELETE \
+https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?api-version=6.0
 ```
 
 ## .NET Client Libraries
@@ -79,7 +118,7 @@ Here, we're using two of the .NET Client Libraries. Make sure you reference the
 - [Microsoft.TeamFoundationServer.Client](https://www.nuget.org/packages/Microsoft.TeamFoundationServer.Client/)
 - [Microsoft.Visual Studio.Services.Client](https://www.nuget.org/packages/Microsoft.VisualStudio.Services.Client/)
 
-See the following example of getting a list of projects for your organization via .NET Client Libraries.
+The following example gets a list of projects for your organization via .NET Client Libraries:
 
 ```cs
 using Microsoft.TeamFoundation.Core.WebApi;
@@ -98,6 +137,8 @@ using (ProjectHttpClient projectHttpClient = new ProjectHttpClient(uri, credenti
 
 ```
 
+## Error handling
+
 ## FAQs
 
 <!-- BEGINSECTION class="md-qanda" -->