API Key Management

API keys authenticate your workloads against ling-1t.ai. Keys are scoped to the owning account and track usage for billing and audit logs.

Create a Key

1. Sign in at https://ling-1t.ai/dashboard.
2. In the API Keys card, select Create API key.
3. Provide a label (e.g., “production-backend”).
4. Copy the generated value immediately—keys are only shown once.

The dashboard displays the prefix and last eight characters for reference. Each account can hold up to MAX_API_KEYS_PER_USER active keys (defaults to 10; configurable via environment variable).

Example Response

{
  "key": "LING1T-2H88K62N-MZP0RQFD-9F4NHQ2D-M2WPK7T4",
  "apiKey": {
    "id": "key_01HZ9W8XV...",
    "name": "production-backend",
    "prefix": "LING1T-2H88K62N",
    "lastEight": "M2WPK7T4",
    "createdAt": "2025-04-01T06:12:43.581Z",
    "revoked": false
  }
}

Store keys securely (secret manager, vault, or CI/CD variable). Avoid committing them to your repository.

Rotate or Revoke

• Use the Revoke action in the dashboard to immediately invalidate a key. Revocation cannot be undone.
• Update your applications to use a new key before revoking the old one to prevent downtime.

Headers at a Glance

Keys are hashed at rest and linked to billing records. Each request updates the key’s last_used_at field for audit trails.