microsoft/api-guidelines

View on GitHub

Microsoft REST API Guidelines

Stars: 23.3k
Forks: 2.7k
Open beginner issues: 0
Indexed issues: 129

Dominant language: No language data
License: No license data
Last GitHub push: Aug 5, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: No beginner labels indexed
PR merge metrics: No merged PRs in 30d

Beginner friendly Everything

Open All

129 issues indexed so far

Clarify Permissive-In / Strict-Out Naming Policy in Guidelines Open

Difficulty 1/5 1-3 hours Newbie friendliness 68/100

microsoft/api-guidelines#571 · Opened Jul 31, 2025
Issue: All down your Review Page is unanswered and unsatisfied Customers. Open

Difficulty 5/5 Over a week Newbie friendliness 5/100

microsoft/api-guidelines#570 · Opened Jul 2, 2025
Im Open

Difficulty 5/5 Over a week Newbie friendliness 10/100

microsoft/api-guidelines#562 · Opened Oct 5, 2024
Continue with the team Open

Difficulty 5/5 Over a week Newbie friendliness 1/100

microsoft/api-guidelines#560 · Opened Sep 9, 2024
Broken link for long running operations Open

Difficulty 1/5 Under an hour Newbie friendliness 58/100

microsoft/api-guidelines#559 · Opened Sep 9, 2024
API Guidance does not explain the term `workload` Open

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

microsoft/api-guidelines#558 · Opened Aug 16, 2024
Integrate uniform versioning guidelines Open

Difficulty 2/5 1-2 days Newbie friendliness 38/100

microsoft/api-guidelines#554 · 1 comment · Opened Jul 16, 2024
Make auth guidelines more explicit Open

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

microsoft/api-guidelines#544 · Opened May 6, 2024
Revisit response time requirements for non-LRO operations Open

Azure Guidelines

Difficulty 4/5 3-5 days Newbie friendliness 35/100

microsoft/api-guidelines#542 · Opened Apr 30, 2024
Add guidelines to prefer "flat" over "nested" structures Open

Azure Guidelines

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

microsoft/api-guidelines#541 · 3 comments · Opened Apr 22, 2024
Re-examine guidance for including eTag in response to PUT request Open

Azure Guidelines

Difficulty 4/5 3-5 days Newbie friendliness 35/100

microsoft/api-guidelines#540 · Opened Apr 22, 2024
Why does collection response use `value` property instead of `values` in Azure API guidelines? Open

Difficulty 1/5 Under an hour Newbie friendliness 25/100

microsoft/api-guidelines#539 · 2 comments · Opened Apr 15, 2024
Have guidance for when to use unschematized models, and what patterns we have available for unschematized models Open

Graph Guidelines

Difficulty 5/5 Over a week Newbie friendliness 30/100

microsoft/api-guidelines#534 · Opened Mar 15, 2024
_Originally posted by @mmtayyar in https://github.com/CVEProject/cve-schema/issues/283_ Open

Difficulty 5/5 Over a week Newbie friendliness 10/100

microsoft/api-guidelines#533 · Opened Mar 14, 2024
?? Open

Difficulty 5/5 Over a week Newbie friendliness 10/100

microsoft/api-guidelines#531 · Opened Mar 1, 2024
Restrictions for openType Open

Graph Guidelines Microsoft Graph

Difficulty 4/5 3-5 days Newbie friendliness 35/100

microsoft/api-guidelines#524 · Opened Feb 7, 2024
Error message localization Open

Graph Guidelines Microsoft Graph

Difficulty 2/5 1-3 hours Newbie friendliness 25/100

microsoft/api-guidelines#518 · 1 comment · Opened Jan 18, 2024
Vague guidelines about point query support Open

Graph Guidelines Microsoft Graph

Difficulty 2/5 1-3 hours Newbie friendliness 52/100

microsoft/api-guidelines#511 · Opened Dec 11, 2023
Xbox box 360 live Open

Difficulty 5/5 Over a week Newbie friendliness 1/100

microsoft/api-guidelines#510 · Opened Nov 27, 2023
The 'at' naming convention Open

Difficulty 5/5 Over a week Newbie friendliness 20/100

microsoft/api-guidelines#508 · Opened Nov 16, 2023
Add clarity to expand requirement Open

Graph Guidelines Microsoft Graph

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

microsoft/api-guidelines#506 · Opened Oct 30, 2023
querying arbitrary number of keys in a dictionary insted Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

microsoft/api-guidelines#498 · 1 comment · Opened Sep 20, 2023
Fix content table in the main Graph guidelines. merger enum and evolvable enum patterns Open

microsoft/api-guidelines#494 · 1 assignee · Opened Aug 27, 2023
Add guidance for pageable post operations Open

Azure Guidelines

Difficulty 4/5 3-5 days Newbie friendliness 35/100

microsoft/api-guidelines#489 · Opened Aug 17, 2023
arbitrary JSON pattern/anti-pattern Open

Difficulty 5/5 Over a week Newbie friendliness 30/100

microsoft/api-guidelines#488 · Opened Aug 11, 2023
Guidance on response payload with 201 Open

Graph Guidelines Microsoft Graph

Difficulty 5/5 Over a week Newbie friendliness 25/100

microsoft/api-guidelines#481 · Opened Jul 20, 2023
HTTP Return Codes don't mention HTTP HEAD Open

Difficulty 2/5 1-3 hours Newbie friendliness 38/100

microsoft/api-guidelines#478 · 8 comments · Opened Jul 12, 2023
Shared Type Design Pattern Open

Graph Guidelines Microsoft Graph

microsoft/api-guidelines#477 · 1 assignee · Opened Jul 10, 2023
Graph specific HTTP Request/Response Open

Graph Guidelines Microsoft Graph

Difficulty 5/5 Over a week Newbie friendliness 25/100

microsoft/api-guidelines#476 · Opened Jul 10, 2023
Throttling pattern Open

Graph Guidelines Microsoft Graph

microsoft/api-guidelines#475 · 1 assignee · Opened Jul 7, 2023
State machine pattern Open

Graph Guidelines Microsoft Graph

Difficulty 5/5 Over a week Newbie friendliness 20/100

microsoft/api-guidelines#474 · 1 comment · Opened Jul 7, 2023
Delete pattern Open

Graph Guidelines Microsoft Graph

microsoft/api-guidelines#473 · 2 assignees · Opened Jul 7, 2023
Complex type pattern Open

Graph Guidelines Microsoft Graph

microsoft/api-guidelines#472 · 1 assignee · Opened Jul 7, 2023
Large File Upload Pattern Open

Graph Guidelines Microsoft Graph

microsoft/api-guidelines#471 · 1 assignee · Opened Jul 7, 2023
Report Pattern Open

Graph Guidelines Microsoft Graph

microsoft/api-guidelines#469 · 1 assignee · Opened Jul 7, 2023
Paging Pattern document Open

Graph Guidelines Microsoft Graph

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

microsoft/api-guidelines#467 · Opened Jul 7, 2023
Add guidelines for graph conventions around read-only properties Open

Graph Guidelines Microsoft Graph

microsoft/api-guidelines#466 · 1 assignee · Opened Jul 7, 2023
Open Type Pattern Open

Graph Guidelines Microsoft Graph

microsoft/api-guidelines#465 · 1 assignee · Opened Jul 7, 2023
Reference implementation REST API Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

microsoft/api-guidelines#459 · 5 comments · 1 reaction · Opened Jun 16, 2023
Add guidance for handling of unrecognized query/header parameter or body property Open

Azure Guidelines

Difficulty 4/5 3-5 days Newbie friendliness 25/100

microsoft/api-guidelines#458 · 4 comments · Opened Jun 9, 2023
Add guidance for when/how Azure services should allow caching of responses Open

Azure Guidelines

Difficulty 5/5 Over a week Newbie friendliness 35/100

microsoft/api-guidelines#455 · Opened May 31, 2023
Hybrid RELO Open

Graph Guidelines

Difficulty 4/5 3-5 days Newbie friendliness 35/100

microsoft/api-guidelines#454 · Opened May 23, 2023
Clarify handling of repeatability of LRO POST action Open

Azure Guidelines

Difficulty 1/5 Under an hour Newbie friendliness 45/100

microsoft/api-guidelines#448 · Opened Apr 19, 2023
Provide guidance for SSE (Server Sent Events) Open

Azure Guidelines

microsoft/api-guidelines#445 · 1 comment · 1 assignee · Opened Mar 29, 2023
Response body is optional and can be returned. Open

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

microsoft/api-guidelines#444 · Opened Mar 24, 2023
Invalid Examples of group versioning table markdown Open

Difficulty 1/5 Under an hour Newbie friendliness 35/100

microsoft/api-guidelines#440 · 3 comments · Opened Mar 14, 2023
Missing requirements for CRUD Open

Graph Guidelines Microsoft Graph

Difficulty 5/5 Over a week Newbie friendliness 25/100

microsoft/api-guidelines#437 · Opened Mar 2, 2023
7.10.2 InnerError has property of InnerError Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

microsoft/api-guidelines#434 · 1 comment · Opened Feb 21, 2023
Thanks for creating this issue! It looks like you may be using an old version of VS Code, the latest stable release is 1.75.0. Please try upgrading to the latest version and checking whether this issue remains. Open

Difficulty 1/5 Under an hour Newbie friendliness 5/100

microsoft/api-guidelines#432 · 1 comment · Opened Feb 9, 2023
Add guidance on case convention for query parameter names Open

Azure Guidelines

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

microsoft/api-guidelines#431 · Opened Feb 1, 2023

microsoft/api-guidelines

Get new issues in your inbox