Skip to content

Commit f5f9684

Browse files
author
Dan Kershaw [MSFT]
committed
Updated guidelines for Upsert
1 parent 512bd54 commit f5f9684

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

graph/GuidelinesGraph.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -256,7 +256,8 @@ If possible, APIs SHOULD use resource-based designs with standard HTTP methods r
256256

257257
| Microsoft Graph rules for modeling behavior |
258258
|------------------------------------------------------------------|
259-
| :heavy_check_mark: **MUST** use POST to create new entities in insertable entity sets or collections.<BR>This approach requires the server to produce system generated identities. |
259+
| :heavy_check_mark: **MUST** use POST to create new entities in insertable entity sets or collections.<BR>This approach requires the server to produce a system generated key. |
260+
| :heavy_check_mark: **MAY** use PATCH to create new entities in insertable entity sets or collections.<BR>This [Upsert](./patterns/upsert.md) approach requires the caller to provide a key. |
260261
| :heavy_check_mark: **MUST** use PATCH to edit updatable resources. |
261262
| :heavy_check_mark: **MUST** use DELETE to delete deletable resources. |
262263
| :heavy_check_mark: **MUST** use GET for listing and reading resources. |
@@ -389,6 +390,7 @@ The guidelines in previous sections are intentionally brief and provide a jump s
389390
| [Navigation properties](./patterns/navigation-property.md) | Model resource relationships |
390391
| [Operations](./patterns/operations.md) | Model complex business operations |
391392
| [Type hierarchy](./patterns/subtypes.md) | Model `is-a` relationships using subtypes. |
393+
| [Upsert](./patterns/upsert.md) | Idempotent operation to create or update a resource using a client-provided key. |
392394

393395
## References
394396

0 commit comments

Comments
 (0)