Launch an agent in the Lucid verified network
Launch an agent via one of two modes:
- image: Deploy a pre-built Docker image (Path A — Bring Your Own Image).
- base-runtime: Deploy a pre-configured base runtime with model, prompt, and optional tools (Path B — No-Code).
Both modes create a passport, deploy to the target provider, and inject Lucid env vars. Returns the passport_id, deployment_id, and deployment URL.
Authorizations
Lucid API key (lk_live_... or lk_test_...)
Body
- Option 1
- Option 2
Launch mode — bring your own Docker image
image Docker image reference (e.g. ghcr.io/myorg/my-agent:latest)
Deployment target provider
docker, railway, akash, phala, ionet, nosana Owner wallet address (Solana base58 or EVM 0x)
Human-readable agent name
Container port to expose (default 8080)
Verification mode (full includes receipts + memory + payment hooks)
full, minimal Additional environment variables injected into the container
Private registry credentials (never stored, used at deploy time only)
Response
Agent launched
Whether the agent is eligible for on-chain reputation scoring
Created passport identifier
Deployment record identifier
Public URL of the deployed agent
Active verification mode
full, minimal SHA-256 hash of the launch configuration (for audit)
Error message (present only when success is false)
.png?fit=max&auto=format&n=VsjUqn6fLqEhBiuI&q=85&s=8b4c7e6431e9a6af1ef23b77bb4ff5fd)
.png?fit=max&auto=format&n=VsjUqn6fLqEhBiuI&q=85&s=d5651a45e4bfbabc33f74e146af3f94a)