# catalog_licenses_program_assignment_create

Create or update a program license assignment

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

## Query parameters:

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

  - `email` (string)
    Filter assignments for a specific email

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

  - `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')

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

## Request fields (application/json):

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

  - `user_id` (integer)
    The user ID to assign the license to (required if email not provided)

  - `username` (string)
    The username to assign the license to (alternative to user_id)

  - `email` (string)
    The email to assign the license to (required if user_id not provided)

  - `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 assignment should be active

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

  - `direct` (boolean)
    Whether the assignment is being directly assigned to the user

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

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

## Response 200 fields (application/json):

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

  - `user_id` (integer,null, required)
    The ID of the user assigned the license

  - `username` (string,null, required)
    The username of the user assigned the license

  - `name` (string,null, required)
    The full name of the user assigned the license

  - `email` (string,null, required)
    The email address of the user assigned the license

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

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

  - `direct` (boolean)
    Whether the assignment was directly assigned to the user (vs. via a group)

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

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

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

  - `modified` (string)
    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