diff --git a/ext/included/index.md b/ext/included/index.md
new file mode 100644
index 000000000..92a4d3a09
--- /dev/null
+++ b/ext/included/index.md
@@ -0,0 +1,95 @@
+# Included Extension
+
+This extension provides a means to embed included resources within the related [resource identifier object](https://jsonapi.org/format/1.1/#document-resource-identifier-objects) instead of the top-level `included` member.
+
+## Namespace
+
+This extension uses the namespace `included`.
+
+> Note: JSON:API extensions can only introduce new document members using a
+> reserved namespace as a prefix.
+
+## Document Structure
+
+A document that supports this extension MAY embed included resources within the related [resource identifier object](https://jsonapi.org/format/1.1/#document-resource-identifier-objects) instead of the top-level `included` member.
+
+This extension adds the following members to related [resource identifier object](https://jsonapi.org/format/1.1/#document-resource-identifier-objects):
+* `included:attributes`
+* `included:relationships`
+* `included:links`
+
+A complete example document with multiple included relationships:
+
+```json
+{
+ "data": {
+ "type": "articles",
+ "id": "1",
+ "attributes": {
+ "title": "JSON:API paints my bikeshed!"
+ },
+ "links": {
+ "self": "http://example.com/articles/1"
+ },
+ "relationships": {
+ "author": {
+ "links": {
+ "self": "http://example.com/articles/1/relationships/author",
+ "related": "http://example.com/articles/1/author"
+ },
+ "data": { "type": "people", "id": "9" },
+ "included:attributes": {
+ "firstName": "Dan",
+ "lastName": "Gebhardt",
+ "twitter": "dgeb"
+ },
+ "included:links": {
+ "self": "http://example.com/people/9"
+ }
+ },
+ "comments": {
+ "links": {
+ "self": "http://example.com/articles/1/relationships/comments",
+ "related": "http://example.com/articles/1/comments"
+ },
+ "data": [
+ {
+ "type": "comments",
+ "id": "5",
+ "included:attributes": {
+ "body": "First!"
+ },
+ "included:relationships": {
+ "author": {
+ "data": { "type": "people", "id": "2" }
+ }
+ },
+ "included:links": {
+ "self": "http://example.com/comments/5"
+ }
+ },
+ {
+ "type": "comments",
+ "id": "12",
+ "included:attributes": {
+ "body": "I like XML better"
+ },
+ "included:relationships": {
+ "author": {
+ "data": { "type": "people", "id": "9" }
+ }
+ },
+ "included:links": {
+ "self": "http://example.com/comments/12"
+ }
+ }
+ ]
+ }
+ }
+ }
+}
+```
+
+
+
+
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy