# RoleGetSchema

1. **kind**  
   - Type: string (Optional)  
   - Description: The kind of record.

2. **metadata**  
   - Type: object ([RoleMetadataSchema](https://docs.mediakind.com/api-reference/management-api/schemas/rolemetadataschema)) (Required)  
     - **categories**  
       - Type: list of strings (Required)  
       - Description: Some capabilities apply to resources at the organization level, some apply only at the project level. This list suggests which categories of scope this role should be combined with.
     - **id**  
       - Type: string (Required)  
       - Format: uuid  
       - Description: The ID of the resource.
     - **name**  
       - Type: string (Optional)  
       - Description: The name of the resource.

3. **spec**  
   - Type: object ([RoleSpecSchema](https://docs.mediakind.com/api-reference/management-api/schemas/rolespecschema)) (Required)  
     - **capabilities**  
       - Type: list of objects ([RoleCapabilitySchema](https://docs.mediakind.com/api-reference/management-api/schemas/rolecapabilityschema)) (Optional)  
         - **capability**  
           - Type: string (Required)  
           - Description: The name of the capability.
         - **description**  
           - Type: string (Required)  
           - Length: 0-256 characters  
           - Description: A description of the role.