Skip to content

Fix broken REST API doc link in ai-projects README#38234

Open
nicholasdbrady wants to merge 2 commits intoAzure:mainfrom
nicholasdbrady:fix/broken-aiprojects-link
Open

Fix broken REST API doc link in ai-projects README#38234
nicholasdbrady wants to merge 2 commits intoAzure:mainfrom
nicholasdbrady:fix/broken-aiprojects-link

Conversation

@nicholasdbrady
Copy link
Copy Markdown

The [ai_foundry_data_plane_rest_apis] reference link at the bottom of the ai-projects README points to /rest/api/aifoundry/aiprojects/operation-groups (plural). That URL 404s on Learn.

The correct path is /rest/api/aifoundry/aiproject/operation-groups (singular).

What changed: One character in the reference link on line 1358.

How I found it: A customer reported broken doc links via OCV after migrating to the new Foundry portal. The NPS auto-analysis confirmed the issue came from REST API doc links. I audited all azure-sdk-for-* repos and this was the only one affected. A matching fix for microsoft-foundry/foundry-samples is at microsoft-foundry/foundry-samples#662.

The reference link for ai_foundry_data_plane_rest_apis pointed to
/aiprojects/ (plural), which 404s. The correct path is /aiproject/
(singular).

Caught via OCV customer feedback (ADO #5203449).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 21, 2026 17:14
@github-actions github-actions Bot added Community Contribution Community members are working on the issue customer-reported Issues that are reported by GitHub users external to the Azure organization. labels Apr 21, 2026
@github-actions
Copy link
Copy Markdown
Contributor

Thank you for your contribution @nicholasdbrady! We will review the pull request and get back to you soon.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR fixes a broken Learn.microsoft.com reference link in the @azure/ai-projects README by correcting the REST API documentation path from aiprojects (plural) to aiproject (singular), addressing a 404.

Changes:

  • Update the [ai_foundry_data_plane_rest_apis] reference URL to the correct Learn REST API path.

The /operation-groups?view=rest-aifoundry-aiprojects-v1 path returns
404 regardless of singular/plural. The working URL is the base REST
API reference page at /rest/api/aifoundry/aiproject.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@nicholasdbrady
Copy link
Copy Markdown
Author

Updated the URL — the initial fix changed aiprojects to aiproject (singular), but the /operation-groups?view=rest-aifoundry-aiprojects-v1 path still 404s on both variants. The correct working URL is the base REST API reference landing page at /rest/api/aifoundry/aiproject (no suffix). Verified it returns 200.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Community Contribution Community members are working on the issue customer-reported Issues that are reported by GitHub users external to the Azure organization.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants