Add user to standard resources

1 files changed, 26 insertions, 0 deletions

diff --git a/api-conventions.md b/api-conventions.md
index 8e12303..04f3098 100644
--- a/api-conventions.md
+++ b/api-conventions.md
@@ -134,6 +134,32 @@ guarantees about interface stability.
 }
 ```
 
+## Standard resources
+
+### User resource
+
+**full form**
+
+```json
+{
+  "canonical_name": "~username",
+  "name": "username",
+  "email": "email",
+  "url": "url" or null,
+  "location": "location" or null,
+  "bio": "bio" or null,
+}
+```
+
+**short form**
+
+```json
+{
+  "canonical_name": "~username",
+  "name": "username",
+}
+```
+
 ## Webhooks
 
 Most resources will have webhooks which can deliver updates to your application