# catalog_licenses_program_assignment_group_create

Create or update a program license group assignment

Endpoint: POST /api/catalog/licenses/program/assignment/group/
Version: 3.59.0-ai-plus
Security: PlatformApiKeyAuthentication

## Query parameters:

  - `active` (boolean)
    Filter by the active status of group assignments

  - `fulfilled` (boolean)
    Filter by the fulfilled status of group assignments

  - `group_id` (integer)
    Filter assignments for a specific user group ID

  - `license_id` (integer, required)
    The ID of the program license

  - `page` (integer)
    Page number for pagination

  - `page_size` (integer)
    Number of results per page

  - `platform_key` (string)
    The unique identifier for the platform

  - `platform_org` (string)
    The organization identifier for the platform

  - `sort` (string)
    Field to sort results by (e.g., 'id', '-id', 'created', '-created')

## Request fields (application/json):

  - `license_id` (integer, required)
    The ID of the program license to assign

  - `group_id` (integer, required)
    The ID of the user group to assign the license to

  - `platform_key` (string)
    The unique identifier for the platform (for permission validation)

  - `platform_org` (string)
    The organization identifier for the platform (for permission validation)

  - `active` (boolean)
    Whether the group assignment should be active

  - `fulfilled` (boolean)
    Whether the group assignment should be marked as fulfilled

  - `redirect_to` (string,null)
    URL to redirect to after fulfillment

  - `metadata` (object)
    Additional metadata for the group assignment

## Response 200 fields (application/json):

  - `id` (integer, required)
    The unique identifier for the assignment

  - `group_id` (integer, required)
    The ID of the group assigned the license

  - `group_name` (string, required)
    The name of the group assigned the license

  - `active` (boolean, required)
    Whether the assignment is active and valid

  - `fulfilled` (boolean, required)
    Whether the assignment has been processed/fulfilled

  - `redirect_to` (string,null, required)
    URL to redirect to after fulfillment

  - `metadata` (object,null, required)
    Additional metadata for the assignment

  - `created` (string, required)
    When the assignment was created

  - `modified` (string, required)
    When the assignment was last modified

  - `license_id` (integer, required)
    The ID of the program license

  - `license_name` (string, required)
    The name of the program license

  - `program_key` (string, required)
    The program key associated with the license

  - `program_name` (string, required)
    The name of the program associated with the license

  - `user_count` (integer, required)
    Number of users in the group

  - `assigned_count` (integer, required)
    Number of users in the group who have been assigned the license