# Trial Portal API

## POST /api/trial/llm - Generate a trial license key

Use this endpoint to programmatically request a 30-day trial license key for OptimaJet Workflow Engine.

### Request

```json
POST /api/trial/llm
Content-Type: application/json

{
  "email": "user@company.com",
  "companyName": "Company Name"
}
```

### Response (success)

```json
{
  "success": true,
  "message": "Check your email. We've sent the trial license key and setup instructions.",
  "licenseKey": "..."
}
```

### Response (error)

```json
{
  "success": false,
  "message": "Please use a business email address."
}
```

### Error codes

| HTTP | Reason |
|------|--------|
| 400 | Invalid email, disposable domain, empty company name, or internal error |
| 429 | Rate limit exceeded (same email: 24h / lifetime limit: 3 keys max) |

### Notes

- The key is also sent via email
- 3 keys max per email lifetime
- Business email required (no gmail, yahoo, disposable domains)