Add API specs to groups endpoints, convert projectId groups endpoints to be slug-based

backend/src/services/org/org-service.ts

@@ -118,7 +118,8 @@ export const orgServiceFactory = ({
   };
 
   const getOrgGroups = async ({ actor, actorId, orgId, actorAuthMethod, actorOrgId }: TGetOrgGroupsDTO) => {
-    await permissionService.getOrgPermission(actor, actorId, orgId, actorAuthMethod, actorOrgId);
+    const { permission } = await permissionService.getOrgPermission(actor, actorId, orgId, actorAuthMethod, actorOrgId);
+    ForbiddenError.from(permission).throwUnlessCan(OrgPermissionActions.Read, OrgPermissionSubjects.Groups);
     const groups = await groupDAL.findByOrgId(orgId);
     return groups;
   };

backend/src/services/org/org-types.ts

@@ -51,7 +51,10 @@ export type TFindAllWorkspacesDTO = {
 };
 
 export type TUpdateOrgDTO = {
+  orgId: string;
   data: Partial<{ name: string; slug: string; authEnforced: boolean; scimEnabled: boolean }>;
 } & TOrgPermission;
 
-export type TGetOrgGroupsDTO = TOrgPermission;
+export type TGetOrgGroupsDTO = {
+  orgId: string;
+} & TOrgPermission;