docs: iam docstrings

Issue: #13

src/iam/router.py

@@ -1,9 +1,19 @@
 """
-Router endpoints for <this module>
+Router endpoints for IAM
 
 Endpoints:
- - List: Description
- - Endpoints: Description
+ - [POST](/iam/can_act_on_resource): [API key & user claim]: Service access point to verify user permissions
+ - [GET](/iam/group/permissions):  [root user]: Gets list of perms(service, resource, action) the given group(id) has
+ - [DELETE](/iam/group/permissions):  [root user]: Removes a given perm(id) from the given group(id)
+ - [GET](/iam/group/users):  [root user]: Gets a list of users(id, name, email) that are assigned to the given group(id)
+ - [POST](/iam/group):  [root user]: Creates a new group for the given org(id)
+ - [PUT](/iam/group/permission):  [root user]: Assigns a perm(id) to the given group(id)
+ - [PUT](/iam/group/user):  [root user]: Assigns a user(id) to a group(id)
+ - [DELETE](/iam/group/user):  [root user]: Removes a user(id) from the given group(id)
+ - [GET](/iam/permissions):  [root user]: Gets a list of all permissions
+ - [POST](/iam/permission):  [super admin]: Creates a new permission
+ - [DELETE](/iam/permission):  [super admin]: Removes a permission
+ - [GET](/iam/permissions/search):  [root user]: Returns a list of permissions matching a filter(service|resource|action)
 """
 from fastapi import APIRouter, status
 from sqlalchemy.exc import IntegrityError