Add initial agent ID samples #1411

FaithOmbongi · 2026-01-19T14:26:24Z

No description provided.

Copilot

Pull request overview

This pull request adds 8 new sample queries for agent-related Microsoft Graph API endpoints in the beta version. The queries cover agent identity blueprints, agent identity blueprint principals, agent identities, and agent users.

Changes:

Added 8 new GET request samples for various agent-related endpoints under the "Agents" category

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-01-19T14:28:28Z

sample-queries/sample-queries.json

+      "id": "76ecc500-897d-4a5e-a15c-0f6702a43d32",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "List agent identity blueprints",
+      "requestUrl": "/beta/applications/microsoft.graph.agentIdentityBlueprint",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprint-list",
+      "skipTest": false
+    },
+    {
+      "id": "76ecc500-897d-4a5e-a15c-0f6702a43d32",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "Get agent identity blueprint",
+      "requestUrl": "/beta/applications/microsoft.graph.agentIdentityBlueprint/{id}",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprint-get",
+      "skipTest": false
+    },
+    {
+      "id": "76ecc500-897d-4a5e-a15c-0f6702a43d32",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "List agent identity blueprint principals",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentityBlueprintPrincipal",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprintprincipal-list",
+      "skipTest": false
+    },
+    {
+      "id": "76ecc500-897d-4a5e-a15c-0f6702a43d32",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "Get agent identity blueprint principal",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentityBlueprintPrincipal/{id}",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprintprincipal-list",
+      "skipTest": false
+    },
+    {
+      "id": "76ecc500-897d-4a5e-a15c-0f6702a43d32",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "List agent identities",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentity",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentity-list",
+      "skipTest": false
+    },
+    {
+      "id": "76ecc500-897d-4a5e-a15c-0f6702a43d32",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "Get agent identity",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentity/{id}",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentity-list",
+      "skipTest": false
+    },
+    {
+      "id": "76ecc500-897d-4a5e-a15c-0f6702a43d32",


All 8 new agent query entries have the same ID "76ecc500-897d-4a5e-a15c-0f6702a43d32". Each query entry should have a unique ID to properly identify and distinguish between different queries.

Copilot · 2026-01-19T14:28:28Z

sample-queries/sample-queries.json

+      "method": "GET",
+      "humanName": "Get agent identity blueprint principal",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentityBlueprintPrincipal/{id}",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprintprincipal-list",


The docLink points to "agentidentityblueprintprincipal-list" which appears to be the LIST operation documentation, but this is a GET operation for a single principal. The docLink should point to the GET operation documentation instead (likely "agentidentityblueprintprincipal-get").

Suggested change

"docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprintprincipal-list",

"docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprintprincipal-get",

Copilot · 2026-01-19T14:28:28Z

sample-queries/sample-queries.json

+      "method": "GET",
+      "humanName": "Get agent identity",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentity/{id}",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentity-list",


The docLink points to "agentidentity-list" which appears to be the LIST operation documentation, but this is a GET operation for a single agent identity. The docLink should point to the GET operation documentation instead (likely "agentidentity-get").

Suggested change

"docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentity-list",

"docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentity-get",

Copilot

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-01-19T14:43:34Z

sample-queries/sample-queries.json

+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprint-list",
+      "skipTest": false
+    },
+    {
+      "id": "646cd7b7-58f8-492e-b8d4-f54aab86628d",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "get agent identity blueprint",
+      "requestUrl": "/beta/applications/microsoft.graph.agentIdentityBlueprint/{id}",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprint-get",
+      "skipTest": false
+    },
+    {
+      "id": "62efe2d1-f889-4724-b370-59fcae5fbab1",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "list agent identity blueprint principals",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentityBlueprintPrincipal",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprintprincipal-list",
+      "skipTest": false
+    },
+    {
+      "id": "1359d5de-354b-4526-8fb2-ad5ec2a0f49a",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "get agent identity blueprint principal",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentityBlueprintPrincipal/{id}",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprintprincipal-get",
+      "skipTest": false
+    },
+    {
+      "id": "46edf0dd-e196-415b-9c41-c1fd3987f7b0",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "list agent identities",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentity",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentity-list",
+      "skipTest": false
+    },
+    {
+      "id": "c8fd74a5-10f3-43ff-a56d-445bbb598d5f",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "get agent identity",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentity/{id}",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentity-get",
+      "skipTest": false
+    },
+    {
+      "id": "cef7b606-dd9f-4a47-80b2-048f9c9b61ac",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "list agent ID users",
+      "requestUrl": "/beta/users/microsoft.graph.agentUser",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentuser-list",


The documentation links use an outdated URL pattern. All other entries in the file use learn.microsoft.com/en-us/graph/api/ for documentation links, but these new entries use developer.microsoft.com/en-us/graph/docs/api-reference/. Update the URLs to use the learn.microsoft.com domain to be consistent with the rest of the file.

Copilot · 2026-01-19T14:43:35Z

sample-queries/sample-queries.json

+      "humanName": "list agent identity blueprints",
+      "requestUrl": "/beta/applications/microsoft.graph.agentIdentityBlueprint",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprint-list",
+      "skipTest": false
+    },
+    {
+      "id": "646cd7b7-58f8-492e-b8d4-f54aab86628d",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "get agent identity blueprint",
+      "requestUrl": "/beta/applications/microsoft.graph.agentIdentityBlueprint/{id}",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprint-get",
+      "skipTest": false
+    },
+    {
+      "id": "62efe2d1-f889-4724-b370-59fcae5fbab1",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "list agent identity blueprint principals",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentityBlueprintPrincipal",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprintprincipal-list",
+      "skipTest": false
+    },
+    {
+      "id": "1359d5de-354b-4526-8fb2-ad5ec2a0f49a",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "get agent identity blueprint principal",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentityBlueprintPrincipal/{id}",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprintprincipal-get",
+      "skipTest": false
+    },
+    {
+      "id": "46edf0dd-e196-415b-9c41-c1fd3987f7b0",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "list agent identities",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentity",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentity-list",
+      "skipTest": false
+    },
+    {
+      "id": "c8fd74a5-10f3-43ff-a56d-445bbb598d5f",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "get agent identity",
+      "requestUrl": "/beta/servicePrincipals/microsoft.graph.agentIdentity/{id}",
+      "docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentity-get",
+      "skipTest": false
+    },
+    {
+      "id": "cef7b606-dd9f-4a47-80b2-048f9c9b61ac",
+      "category": "Agents",
+      "method": "GET",
+      "humanName": "list agent ID users",


The humanName values should follow the existing naming convention of using lowercase for the first word. For consistency with all other entries in the file, change "List" to "list" and "Get" to "get" in these humanName values.

Copilot

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Add initial agent ID samples

5445709

FaithOmbongi requested a review from a team as a code owner January 19, 2026 14:26

Copilot AI review requested due to automatic review settings January 19, 2026 14:26

Copilot started reviewing on behalf of FaithOmbongi January 19, 2026 14:26 View session

Copilot AI reviewed Jan 19, 2026

View reviewed changes

Address review feedback

8f6eec2

FaithOmbongi requested a review from Copilot January 19, 2026 14:40

Copilot started reviewing on behalf of FaithOmbongi January 19, 2026 14:40 View session

Add code review suggestion

0061abd

Copilot AI reviewed Jan 19, 2026

View reviewed changes

Apply latest round of review feedback

b609a73

FaithOmbongi requested a review from Copilot January 19, 2026 16:31

Copilot started reviewing on behalf of FaithOmbongi January 19, 2026 16:31 View session

Copilot AI reviewed Jan 19, 2026

View reviewed changes

FaithOmbongi requested a review from Copilot January 20, 2026 13:39

Copilot started reviewing on behalf of FaithOmbongi January 20, 2026 13:40 View session

Copilot AI reviewed Jan 20, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add initial agent ID samples #1411

Add initial agent ID samples #1411

Uh oh!

FaithOmbongi commented Jan 19, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Jan 19, 2026

Uh oh!

Copilot AI Jan 19, 2026

Uh oh!

Copilot AI Jan 19, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Jan 19, 2026

Uh oh!

Copilot AI Jan 19, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

	"docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprintprincipal-list",
	"docLink": "https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/api/agentidentityblueprintprincipal-get",

Add initial agent ID samples #1411

Are you sure you want to change the base?

Add initial agent ID samples #1411

Uh oh!

Conversation

FaithOmbongi commented Jan 19, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant