# LXI.be developer and agent reference

LXI.be provides domains, hosting and AI tools through one verified customer account. The public API base URL is `https://lxi.be/api/v1`. Its OpenAPI 3.1 contract is available at `https://lxi.be/openapi.json`.

## Authentication and safety

Use `lxi auth login` for browser-based CLI device authorization, or create API tokens at `https://lxi.be/account/developer`. Send the token as `Authorization: Bearer TOKEN`. Tokens are shown once and stored server-side only as a keyed hash. Give each client its own token and only the scopes it needs: `read`, `domains`, `hosting`, `billing`, `ai`, `maker`, or `webhooks`. Revoke a token from the customer center when it is no longer used. For unattended jobs, pass it through `LXI_API_TOKEN`.

## Capabilities

- Account: read account, plan, usage limits, services and domains.
- Domains: check availability and customer price, create an idempotent order, complete payment, list owned domains, and manage A, AAAA, CNAME, MX, TXT and CAA records.
- Hosting and mail: provision a site, inspect asynchronous jobs, list services, and create, update or delete mailboxes.
- AI chat: submit role-based chat messages to `/chat/completions`. Use the stable public model alias `lxi-chat`.
- Translation: submit text, source language or `auto`, and target language to `/translations`.
- Maker: list, create and inspect software projects; send feedback; approve pending plans; retry failed work.
- Webhooks: subscribe an HTTPS endpoint to domain, hosting, DNS, mailbox and order events. Deliveries are signed with HMAC-SHA256 and retried.

## Error handling

Errors are JSON objects with `error.code`, `error.message`, and `error.request_id`. Preserve the request ID when contacting support. Use HTTP status and error code for program logic, not the human message.

## CLI

Download the official Python CLI at `https://lxi.be/downloads/lxi-cli.zip`. It supports account and usage inspection, domain checks and orders, DNS, hosting, mailboxes, webhooks, chat, translation and Maker workflows. Add `--json` before the command for compact machine-readable output. Shell completion is available for Bash, Zsh and Fish.

## Canonical documentation

- https://lxi.be/developers
- https://lxi.be/developers/api
- https://lxi.be/developers/cli
- https://lxi.be/developers/authentication
- https://lxi.be/developers/webhooks
- https://lxi.be/developers/sdks
- https://lxi.be/openapi.json