ibl-data-manager (3.59.0-ai-plus)

Remove a user license group assignment

Create a new user license

API View for updating existing user licenses.

This endpoint allows administrators to update the properties of an existing user license.

Methods: POST: Update an existing user license

Request Body: A JSON object containing:

• license_id (int, optional): The ID of the license to update (required if external_id not provided)
• external_id (str, optional): External identifier of the license to update (required if license_id not provided)
• name (str, optional): Updated display name for the license
• count (int, optional): Updated number of seats purchased
• started (datetime, optional): Updated date when license should begin
• expired (datetime, optional): Updated date when license should expire
• active (bool, optional): Updated active status
• metadata (dict, optional): Updated additional license metadata
• enrollment_config (dict, optional): Updated enrollment configuration
• source (str, optional): Updated source identifier
• change_type (str, optional): Type of change being made (default: "update")

Returns: POST: A JSON response containing the updated license: { "id": 123, "created": "2023-06-15T14:30:00Z", "started": "2023-06-15T14:30:00Z", "expired": "2024-06-15T14:30:00Z", "name": "Updated User License 2023", "count": 150, "active": true, "metadata": {"updated": true}, "source": "updated-source", "external_id": "ext-123", "platform_key": "platform1" }

Error Responses: 400 Bad Request: If required parameters are missing or invalid 401 Unauthorized: If the user is not authenticated 403 Forbidden: If the user does not have permission to update licenses 404 Not Found: If the specified license doesn't exist 500 Internal Server Error: If an unexpected error occurs during license update

Access Control:

• Requires IsDMAdmin permission
• Available only to DM administrators

Notes:

• Cannot update the platform associated with a license
• A license history record is automatically created for each update