@odata.type is marked required in the OpenAPI schemas but is omitted from most GET responses
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 55/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Quiet
- Tech stack
- openapi
- Domain
- api, backend-api-design
Research direction
Inspect the Graph v1.0 OpenAPI description and the entity schemas used by GET /teams/{team-id}; compare their required arrays with the documented response behavior. Done means @odata.type is not required for ordinary responses while remaining accurate for polymorphic instances.
Written by the indexing model from the issue text.
Description
Graph v1.0 OpenAPI description, @odata.type is included in the required array of many entity schemas. However, Graph does not return @odata.type in most GET responses, it's emitted only for polymorphic instances where the concrete type differs from the declared type. This makes the spec internally inconsistent and response that conforms to the API contradicts its own schema's required constraint.
Reproduction
GET /teams/{team-id} the returned team object has no @odata.type, yet the schema marks it required.
- Dominant language
- XSLT
- Stars
- 166
- Forks
- 55
- Avg merge
- 16h 12m
- Merged PRs (30d)
- 14
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from microsoftgraph/msgraph-metadata
-
ToTriage
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
microsoftgraph/msgraph-metadata#1192 ·
-
ToTriage
Difficulty 3/5 1-2 days Newbie friendliness 72/100
microsoftgraph/msgraph-metadata#1193 · 2 comments ·
-
ToTriage
Difficulty 4/5 3-5 days Newbie friendliness 45/100
microsoftgraph/msgraph-metadata#1169 · 1 reaction ·
-
machine OpenToTriage
Difficulty 5/5 Over a week Newbie friendliness 15/100
microsoftgraph/msgraph-metadata#1143 ·
-
ToTriage
microsoftgraph/msgraph-metadata#1088 · 1 comment · 1 assignee ·
All issues in microsoftgraph/msgraph-metadata
Similar issues
-
bug clawsweeper:linked-pr-open clawsweeper:needs-live-repro clawsweeper:no-new-fix-pr impact:message-loss issue-rating: 🐚 platinum hermit P2 regression
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
Difficulty 1/5 Under an hour Newbie friendliness 90/100
AXERA-TECH/ax-llm#77 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 90/100
games-on-whales/wolf#509 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 72/100