Skip to main content

Authentication

Langbly uses API keys for the translate endpoint.

Send your key​

Recommended:

  • Header: X-API-Key: <key>

Also supported (not recommended in production):

  • Query param: ?key=<key>

Errors​

  • Missing key: 401 UNAUTHENTICATED
  • Invalid/disabled key: 401 UNAUTHENTICATED
  • Key not linked to an account: 401 UNAUTHENTICATED

See Errors for the full error format.

Frequently asked questions​

Where do I create an API key?​

Create and manage your API keys in the dashboard at langbly.com/dashboard/keys. Each key is tied to your account.

How do I send the API key in a request?​

Send it as the X-API-Key header. For testing only, you can use the ?key= query parameter, but this is not recommended for production.

POST /language/translate/v2 HTTP/1.1
Host: api.langbly.com
X-API-Key: your-api-key-here

What happens if my API key is invalid or disabled?​

You receive a 401 UNAUTHENTICATED response. This happens if the key is missing, invalid, disabled, or not linked to an account.

{
  "error": {
    "code": 401,
    "message": "Missing API key",
    "status": "UNAUTHENTICATED"
  }
}

Can I disable a key without deleting it?​

Yes. Go to the dashboard and disable the key. Any further requests using that key will return 401 UNAUTHENTICATED.

Does each API key have different permissions or scopes?​

No. Every API key has full access to all endpoints on the account it belongs to. There are no per-key scopes or permissions. Rate limits are a separate topic; see the Limits and timeouts page for details.