chore: minor clean ups

server/src/api_endpoints/personas/roles.js

@@ -30,6 +30,15 @@ const createPersonaRoles = async (req, res, next) => {
   }
 }
 
+/**
+ * HTTP request handler
+ * Delete a persona role by persona key and role key and send 204 on success
+ *
+ * @param {Object} req - The request object
+ * @param {Object} res - The response object
+ * @param {Function} next - The next middleware function
+ * @returns {Promise<void>} - A promise that resolves to void
+ */
 const deletePersonaRole = async (req, res, next) => {
   try {
     const { persona_key: personaKey, role_key: roleKey } = req.params

server/test/endpoint_admin_personas_roles.test.js

@@ -152,6 +152,14 @@ describe('Admin Personas Roles', () => {
   })
 
   describe('DELETE:/personas/{persona_key}/roles/{role_key}', () => {
+    /**
+     * Helper function to make an HTTPS request to delete a persona role.
+     *
+     * @param {string} roleKey - The role key
+     * @param {string} personaKey - The persona key
+     * @param {Object} header - The request headers
+     * @returns {Promise<Response>} - A promise that resolves to the HTTP response
+     */
     const deletePersonasRoles = async (roleKey, personaKey = testPersonaKey, header = requestHeaders) => {
       return await fetch(`${url}/personas/${personaKey}/roles/${roleKey}`, {
         method: 'DELETE',

server/the-usher-openapi-spec.yaml

@@ -547,10 +547,10 @@ paths:
       responses:
         204:
           description: Empty response on success
-        401:
-          $ref: '#/components/responses/Unauthorized'
         400:
           $ref: '#/components/responses/BadRequest'
+        401:
+          $ref: '#/components/responses/Unauthorized'
         404:
           $ref: '#/components/responses/NotFound'
         500:
@@ -634,10 +634,10 @@ paths:
       responses:
         204:
           description: Empty response on success
-        401:
-          $ref: '#/components/responses/Unauthorized'
         400:
           $ref: '#/components/responses/BadRequest'
+        401:
+          $ref: '#/components/responses/Unauthorized'
         404:
           $ref: '#/components/responses/NotFound'
         500: