# catalog_invitations_program_redeem_create

API View for redeeming blank program invitations.

This endpoint allows redeeming a blank program invitation by associating it with a user.

Request Parameters:
    program_key (str, required): The program key for the invitation
    source (str, required): The source identifier for the invitation
    email (str, optional): The email to associate with the invitation
    username (str, optional): The username to associate with the invitation
    metadata fields: Any additional parameters will be added as metadata

Methods:
    POST: Redeem a blank program invitation

Returns:
    POST: A JSON response containing the redeemed invitation:
        {
            "id": 123,
            "user_id": 456,
            "username": "username",
            "email": "user@example.com",
            "created": "2023-06-15T14:30:00Z",
            "started": "2023-06-15T14:30:00Z",
            "source": "source",
            "redirect_to": "https://example.com",
            "expired": null,
            "active": true,
            "metadata": {},
            "program_key": "org+program1"
        }

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 access this resource
    404 Not Found: If no blank invitation is available
    500 Internal Server Error: If an unexpected error occurs during redemption

Access Control:
    - Requires IsDMAdmin or IsPlatformAdminForProgram permission
    - Available to DM admins and platform admins for the specific program

Endpoint: POST /api/catalog/invitations/program/redeem/
Version: 3.59.0-ai-plus
Security: PlatformApiKeyAuthentication

## Request fields (application/json):

  - `program_key` (string, required)
    The program key for the invitation

  - `source` (string, required)
    The source identifier for the invitation

  - `email` (string)
    The email to associate with the invitation

  - `username` (string)
    The username to associate with the invitation

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

## Response 200 fields (application/json):

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

  - `user_id` (integer,null, required)
    The ID of the user associated with the invitation

  - `username` (string,null, required)
    The username of the user associated with the invitation

  - `email` (string,null, required)
    The email address associated with the invitation

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

  - `started` (string,null, required)
    When the invitation was started

  - `expired` (string,null, required)
    When the invitation expires

  - `source` (string,null, required)
    The source of the invitation

  - `redirect_to` (string,null, required)
    URL to redirect to after accepting the invitation

  - `active` (boolean, required)
    Whether the invitation is active

  - `metadata` (object, required)
    Additional metadata for the invitation

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