diff --git a/nerm/schemas/PATCH/Role.yaml b/nerm/schemas/PATCH/Role.yaml
index c596b34..3c26b2f 100644
--- a/nerm/schemas/PATCH/Role.yaml
+++ b/nerm/schemas/PATCH/Role.yaml
@@ -3,11 +3,19 @@ properties:
   type:
     type: string
     enum: [NeprofileRole, NeaccessRole]
+    description: The type of role
+    example: NeprofileRole
   name:
     type: string
-    example: "Sponsors"
+    example: Sponsors
+    description: The name of the user role
+  archived:
+    type: boolean
+    description: Set to true to archive, false to unarchive 
+    example: true
   groups:
     type: array
+    description: Role groups
     items:
       type: string
       example: "ad_group_name"
\ No newline at end of file