Skip to main content
POST
Typescript (SDK)

Authorizations

Authorization
string
header
required

Lucid API key (lk_live_... or lk_test_...)

Body

application/json
mode
enum<string>
required

Launch mode — bring your own Docker image

Available options:
image
image
string
required

Docker image reference (e.g. ghcr.io/myorg/my-agent:latest)

target
enum<string>
required

Deployment target provider

Available options:
docker,
railway,
akash,
phala,
ionet,
nosana
owner
string
required

Owner wallet address (Solana base58 or EVM 0x)

name
string
required

Human-readable agent name

port
integer

Container port to expose (default 8080)

verification
enum<string>
default:full

Verification mode (full includes receipts + memory + payment hooks)

Available options:
full,
minimal
env_vars
object

Additional environment variables injected into the container

registry_auth
object

Private registry credentials (never stored, used at deploy time only)

Response

Agent launched

success
boolean
required
reputation_eligible
boolean
required

Whether the agent is eligible for on-chain reputation scoring

passport_id
string

Created passport identifier

deployment_id
string

Deployment record identifier

deployment_url
string

Public URL of the deployed agent

verification_mode
enum<string>

Active verification mode

Available options:
full,
minimal
config_hash
string

SHA-256 hash of the launch configuration (for audit)

error
string

Error message (present only when success is false)