microsoftgraph / microsoftgraph/msgraph-metadata

Review Delta functions capability annotations for query parameters

Open
#298 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority:p3
Dominant language
XSLT
Stars
166
Forks
55
Avg merge
16h 12m
Merged PRs (30d)
14

Description

API owners should ensure delta functions should have accurate capability annotations for OData query parameters as described at https://learn.microsoft.com/en-us/graph/delta-query-overview#optional-query-parameters.

For example, /users/{user-id}/delta currently has orderby and top, which are not supported by the API.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the delta function capability annotations against the optional query parameters described in the linked delta-query overview. Check the /users/{user-id}/delta example first, then inspect other delta functions for the same mismatch. Done means unsupported parameters such as orderby and top are no longer advertised.

Written by the indexing model from the issue text.

Assessment

Domain
api, backend-api-design
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.