Skip to main content

POST /api/validate-key

Validates a license key and returns GHCR credentials on success.

Rate Limit: 10 requests per minute

Request

{
"license_key": "WW-XXXX-XXXX-XXXX-XXXX",
"machine_id": "optional-unique-machine-identifier"
}

Success Response (200)

{
"valid": true,
"ghcr_token": "...",
"ghcr_username": "ignominiousham",
"registry": "ghcr.io",
"expires_at": "2025-12-31T00:00:00"
}

Error Responses

StatusReason
400Missing license_key field
401Invalid or expired license key
403Maximum activations reached