# catalog_suggestions_pathway_manage_group_create API View for managing pathway group suggestions. This endpoint allows administrators to view, create, and delete pathway suggestions for groups of users within a platform. Query Parameters (GET): platform_key (str, required): The platform to retrieve group suggestions for platform_org (str, optional): The organization identifier for the platform query (str, optional): Search term to filter group suggestions sort (str, optional): Field to sort results by (default: 'id') department_mode (bool, optional): Filter suggestions by department admin access page (int, optional): Page number for pagination page_size (int, optional): Number of items per page Methods: GET: Retrieve a paginated list of pathway group suggestions for a platform POST: Create or update a pathway group suggestion DELETE: Remove a pathway group suggestion Request Body (POST): A JSON object containing: - platform_key (str, required): The platform for the group suggestion - pathway_id (str, required): The pathway ID to suggest - group_id (str/int, required): The group to suggest the pathway to - accepted (bool, optional): Whether the suggestion is accepted - visible (bool, optional): Whether the suggestion is visible - metadata (dict, optional): Additional suggestion metadata Query Parameters (DELETE): suggestion_id (int, required): The ID of the group suggestion to delete Returns: GET: A paginated JSON response containing pathway group suggestions: { "count": 5, "next": "https://example.com/api/catalog/suggestions/pathway/group/?page=2", "previous": null, "results": [ { "id": 123, "group_id": 789, "group_name": "Engineering Team", "platform_key": "platform1", "accepted": false, "visible": true, "created": "2023-06-15T14:30:00Z", "modified": "2023-06-15T14:30:00Z", "metadata": {}, "pathway_id": "pathway-v1:org+pathway+run", "pathway_uuid": "12345678-1234-5678-1234-567812345678", "pathway_name": "Data Science Pathway", "pathway_platform_key": "platform1", "user_count": 25 }, ... ] } POST: A JSON response containing the created/updated group suggestion: { "id": 123, "group_id": 789, "group_name": "Engineering Team", "platform_key": "platform1", "accepted": false, "visible": true, "created": "2023-06-15T14:30:00Z", "modified": "2023-06-15T14:30:00Z", "metadata": {}, "pathway_id": "pathway-v1:org+pathway+run", "pathway_uuid": "12345678-1234-5678-1234-567812345678", "pathway_name": "Data Science Pathway", "pathway_platform_key": "platform1", "user_count": 25 } DELETE: A success response with status 200 Error Responses: 400 Bad Request: If required parameters are missing or invalid, or if group suggestion operations fail 401 Unauthorized: If the user is not authenticated 403 Forbidden: If the user does not have permission to manage group suggestions 500 Internal Server Error: If an unexpected error occurs Access Control: - Requires IsDMAdmin, IsPlatformAdmin, or IsDepartmentModeAdminInPlatform permission - Platform admins can manage group suggestions for their platform - Department admins can manage group suggestions for their departments - DM admins can manage all group suggestions Endpoint: POST /api/catalog/suggestions/pathway/manage/group/ Version: 3.59.0-ai-plus Security: PlatformApiKeyAuthentication ## Query parameters: - `department_mode` (boolean) Filter suggestions by department admin access - `page` (integer) Page number for pagination - `page_size` (integer) Number of items per page - `platform_key` (string, required) The platform to retrieve group suggestions for - `platform_org` (string) The organization identifier for the platform - `query` (string) Search term to filter group suggestions - `sort` (string) Field to sort results by ## Request fields (application/json): - `platform_key` (string, required) The platform for the group suggestion - `platform_org` (string) The organization identifier for the platform - `pathway_uuid` (string, required) The pathway UUID to suggest - `group_id` (integer, required) The group to suggest the pathway to - `accepted` (boolean) Whether the suggestion is accepted - `visible` (boolean) Whether the suggestion is visible - `metadata` (object) Additional suggestion metadata - `suggested_by` (string) The user who suggested the group - `department_mode` (boolean) Flag to ensure department admins can call the API ## Response 200 fields (application/json): - `id` (integer, required) The unique identifier for the group suggestion - `group_id` (integer, required) The ID of the group receiving the suggestion - `group_name` (string, required) The name of the group receiving the suggestion - `platform_key` (string, required) The platform key associated with the suggestion - `accepted` (boolean) Whether the suggestion has been accepted - `visible` (boolean, required) Whether the suggestion is visible - `created` (string, required) When the suggestion was created - `modified` (string, required) When the suggestion was last modified - `metadata` (object, required) Additional metadata for the suggestion - `pathway_id` (string, required) The pathway ID being suggested - `pathway_uuid` (string, required) The UUID of the pathway being suggested - `pathway_name` (string, required) The name of the pathway being suggested - `pathway_platform_key` (string, required) The platform key associated with the pathway - `user_count` (integer) Number of users in the group