Skip to main content
Same commands as LiveKit Cloud. lk agent deploy uploads your code, builds a container image on Telnyx’s build service, and deploys the worker.

1. Create your agent

lk agent create .
Registers the agent and writes the agent ID to livekit.toml. Skip this if you’ve already created the agent.

2. Deploy

lk agent deploy . --secrets TELNYX_API_KEY=$TELNYX_API_KEY
Subsequent deploys roll out a new version.

3. Check status

lk agent list

4. Tail logs

lk agent logs --id <AGENT_ID>
For build logs:
lk agent logs --id <AGENT_ID> --log-type build

5. Update secrets

Add or update secrets on a running agent:
lk agent update-secrets <AGENT_ID> --secrets "OPENAI_API_KEY=<your-key>"

6. Rollback

lk agent rollback <AGENT_ID>

What gets auto-injected

The platform injects these into your agent’s environment at runtime — you don’t need to set them manually:
  • LIVEKIT_URL
  • LIVEKIT_API_KEY — your Telnyx API key
  • LIVEKIT_API_SECRET

More

  • Secrets — Managing API keys and sensitive config
  • Configuration — Regions, multi-agent projects, env vars
  • Management — What Telnyx manages vs. what you control