Skip to content

Commit a6eae42

Browse files
msewawerumsewaweru
committed
Merge branch 'mcp-azure-foundry' of https://github.com/msewaweru/microsoft-graph-docs into mcp-azure-foundry
2 parents 0984c89 + b77928d commit a6eae42

932 files changed

Lines changed: 18281 additions & 963 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/copilot-instructions.md‎

Lines changed: 111 additions & 234 deletions
Large diffs are not rendered by default.

‎.github/prompts/author-api-docs/enumerations.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,8 @@ Create a dedicated topic for the enumeration. This option is rarely applicable.
126126

127127
1. **Create enum topic:**
128128
- Title: "{enum-type} enum type"
129-
- Single sentence describing the enum's purpose
129+
- doc_type: "enumPageType"
130+
- Single sentence describing the enum's purpose, linking to consuming resource(s)
130131
- **For flagged enums:** Append "This flagged enumeration allows multiple members to be selected simultaneously." to the introductory text.
131132
- **For evolvable enums:** Mention it's an evolvable enumeration
132133

‎AGENTS.md‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# Agent Quick Guide
2+
3+
Top-level entrypoint for agents working in this repository.
4+
5+
## Authority
6+
7+
If this file and `.github/copilot-instructions.md` ever differ, follow:
8+
9+
1. `.github/copilot-instructions.md`
10+
2. The prompt and template files it routes you to
11+
12+
This file is intentionally thin to avoid split-brain guidance.
13+
14+
## Read first
15+
16+
Before doing docs work in this repo:
17+
18+
1. Read `.github/copilot-instructions.md`
19+
2. Determine whether the task is **authoring/updating** or **review**
20+
3. Load the prompt file that `.github/copilot-instructions.md` tells you to read first
21+
22+
## Repo map
23+
24+
- `api-reference/*/api/` — API operation topics
25+
- `api-reference/*/resources/` — resource and enum topics
26+
- `changelog/` — API change records
27+
- `concepts/whats-new-overview.md` — monthly release highlights
28+
- `concepts/` — conceptual topics such as tutorials, conceptual overviews, guides
29+
- `api-reference/*/toc/toc.mapping.json` — API reference TOC mapping
30+
- `api-reference/*/includes/rbac-for-apis/` — RBAC include files
31+
- `temp-docstubs/` — temporary authoring inputs
32+
33+
## Workflow
34+
35+
1. Start with `.github/copilot-instructions.md`
36+
2. Load the correct scenario guidance
37+
3. Make scoped changes only
38+
4. Run the validation expected by the loaded workflow
39+
40+
## Rule of thumb
41+
42+
Do not duplicate detailed rules in this file. Keep detailed authoring, review, changelog, What's New, TOC, enum, and RBAC guidance in the files referenced by `.github/copilot-instructions.md`.

‎api-reference/beta/api/agentuser-delete-sponsors.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,10 +71,30 @@ The following example shows a request.
7171
DELETE https://graph.microsoft.com/beta/users/{usersId}/sponsors/{id}/$ref
7272
```
7373

74+
# [C#](#tab/csharp)
75+
[!INCLUDE [sample-code](../includes/snippets/csharp/delete-sponsors-from-agentuser-csharp-snippets.md)]
76+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
77+
78+
# [Go](#tab/go)
79+
[!INCLUDE [sample-code](../includes/snippets/go/delete-sponsors-from-agentuser-go-snippets.md)]
80+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
81+
82+
# [Java](#tab/java)
83+
[!INCLUDE [sample-code](../includes/snippets/java/delete-sponsors-from-agentuser-java-snippets.md)]
84+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
85+
7486
# [JavaScript](#tab/javascript)
7587
[!INCLUDE [sample-code](../includes/snippets/javascript/delete-sponsors-from-agentuser-javascript-snippets.md)]
7688
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
7789

90+
# [PHP](#tab/php)
91+
[!INCLUDE [sample-code](../includes/snippets/php/delete-sponsors-from-agentuser-php-snippets.md)]
92+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
93+
94+
# [Python](#tab/python)
95+
[!INCLUDE [sample-code](../includes/snippets/python/delete-sponsors-from-agentuser-python-snippets.md)]
96+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
97+
7898
---
7999

80100
### Response

‎api-reference/beta/api/agentuser-post-sponsors.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,10 +77,30 @@ Content-Type: application/json
7777
}
7878
```
7979

80+
# [C#](#tab/csharp)
81+
[!INCLUDE [sample-code](../includes/snippets/csharp/create-sponsor-agentuser-csharp-snippets.md)]
82+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
83+
84+
# [Go](#tab/go)
85+
[!INCLUDE [sample-code](../includes/snippets/go/create-sponsor-agentuser-go-snippets.md)]
86+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
87+
88+
# [Java](#tab/java)
89+
[!INCLUDE [sample-code](../includes/snippets/java/create-sponsor-agentuser-java-snippets.md)]
90+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
91+
8092
# [JavaScript](#tab/javascript)
8193
[!INCLUDE [sample-code](../includes/snippets/javascript/create-sponsor-agentuser-javascript-snippets.md)]
8294
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
8395

96+
# [PHP](#tab/php)
97+
[!INCLUDE [sample-code](../includes/snippets/php/create-sponsor-agentuser-php-snippets.md)]
98+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
99+
100+
# [Python](#tab/python)
101+
[!INCLUDE [sample-code](../includes/snippets/python/create-sponsor-agentuser-python-snippets.md)]
102+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
103+
84104
---
85105

86106
### Response

‎api-reference/beta/api/authentication-list-externalauthenticationmethods.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Namespace: microsoft.graph
1616

1717
Get a list of the [externalAuthenticationMethod](../resources/externalauthenticationmethod.md) objects and their properties.
1818

19-
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
19+
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
2020

2121
## Permissions
2222

‎api-reference/beta/api/authentication-post-externalauthenticationmethods.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Namespace: microsoft.graph
1616

1717
Create a new [externalAuthenticationMethod](../resources/externalauthenticationmethod.md) object. This API doesn't support self-service operations.
1818

19-
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
19+
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
2020

2121
## Permissions
2222

‎api-reference/beta/api/channel-list-messages.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ This method supports the following [OData query parameters](/graph/query-paramet
4949
| Name | Description |
5050
|:----------|:---------------------|
5151
| [$top](/graph/query-parameters#top-parameter)| Apply `$top` to specify the number of channel messages returned per page in the response. The default page size is 20 messages. You can extend up to 50 channel messages per page. |
52-
| [$expand](/graph/query-parameters#expand) | Apply `$expand` to get the properties of channel messages that are replies. By default, a response can include up to 1,000 replies. For an operation that expands channel messages with more than 1,000 replies, use the request URL returned in `replies@odata.nextLink` to get the next page of replies. |
52+
| [$expand](/graph/query-parameters#expand) | Apply `$expand` to get the properties of channel messages that are replies. By default, a response can include up to 200 replies. For an operation that expands channel messages with more than 200 replies, use the request URL returned in `replies@odata.nextLink` to get the next page of replies. |
5353

5454
The other [OData query parameters](/graph/query-parameters) aren't currently supported.
5555

‎api-reference/beta/api/chat-delete-targetedmessages.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
1616

1717
Delete a specific [targeted message](../resources/targetedchatmessage.md) from a chat context. Teams administrators can use this API to remove targeted messages from group chats.
1818

19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
20+
1921
## Permissions
2022

2123
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
@@ -72,10 +74,30 @@ The following example shows a request.
7274
DELETE https://graph.microsoft.com/beta/users/f47b5f54-6968-4706-a522-31e842b12345/chats/19:eeaa4e946d674c4f8d4dded613780f45@thread.v2/targetedMessages/1580849738240
7375
```
7476

77+
# [C#](#tab/csharp)
78+
[!INCLUDE [sample-code](../includes/snippets/csharp/delete-targetedchatmessage-csharp-snippets.md)]
79+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
80+
81+
# [Go](#tab/go)
82+
[!INCLUDE [sample-code](../includes/snippets/go/delete-targetedchatmessage-go-snippets.md)]
83+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
84+
85+
# [Java](#tab/java)
86+
[!INCLUDE [sample-code](../includes/snippets/java/delete-targetedchatmessage-java-snippets.md)]
87+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
88+
7589
# [JavaScript](#tab/javascript)
7690
[!INCLUDE [sample-code](../includes/snippets/javascript/delete-targetedchatmessage-javascript-snippets.md)]
7791
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
7892

93+
# [PHP](#tab/php)
94+
[!INCLUDE [sample-code](../includes/snippets/php/delete-targetedchatmessage-php-snippets.md)]
95+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
96+
97+
# [Python](#tab/python)
98+
[!INCLUDE [sample-code](../includes/snippets/python/delete-targetedchatmessage-python-snippets.md)]
99+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
100+
79101
---
80102

81103
### Response

‎api-reference/beta/api/cloudpcdeviceimage-retryupload.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,10 +65,30 @@ The following example shows a request.
6565
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/deviceImages/594e2046-2a4f-43d3-829c-be36bb984f11/retryUpload
6666
```
6767

68+
# [C#](#tab/csharp)
69+
[!INCLUDE [sample-code](../includes/snippets/csharp/retryupload-deviceimages-from-virtualendpoint-csharp-snippets.md)]
70+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
71+
72+
# [Go](#tab/go)
73+
[!INCLUDE [sample-code](../includes/snippets/go/retryupload-deviceimages-from-virtualendpoint-go-snippets.md)]
74+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
75+
76+
# [Java](#tab/java)
77+
[!INCLUDE [sample-code](../includes/snippets/java/retryupload-deviceimages-from-virtualendpoint-java-snippets.md)]
78+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
79+
6880
# [JavaScript](#tab/javascript)
6981
[!INCLUDE [sample-code](../includes/snippets/javascript/retryupload-deviceimages-from-virtualendpoint-javascript-snippets.md)]
7082
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
7183

84+
# [PHP](#tab/php)
85+
[!INCLUDE [sample-code](../includes/snippets/php/retryupload-deviceimages-from-virtualendpoint-php-snippets.md)]
86+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
87+
88+
# [Python](#tab/python)
89+
[!INCLUDE [sample-code](../includes/snippets/python/retryupload-deviceimages-from-virtualendpoint-python-snippets.md)]
90+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
91+
7292
---
7393

7494
### Response

0 commit comments

Comments
 (0)