Skip to main content
POST
/
v1
/
agents
/
launch
Typescript (SDK)
import { RaijinLabsLucidAi } from "raijin-labs-lucid-ai";

const raijinLabsLucidAi = new RaijinLabsLucidAi({
  bearerAuth: process.env["RAIJINLABSLUCIDAI_BEARER_AUTH"] ?? "",
});

async function run() {
  const result = await raijinLabsLucidAi.agents.launch.lucidLaunchAgent({
    mode: "image",
    image: "ghcr.io/myorg/my-agent:latest",
    target: "railway",
    owner: "7xK9mQ2vNbPfYkRd3JhEzV1LnWqA8tUcGp4SyDfH5Bo",
    name: "my-trading-agent",
    verification: "full",
  });

  console.log(result);
}

run();
{
  "success": true,
  "reputation_eligible": true,
  "passport_id": "<string>",
  "deployment_id": "<string>",
  "deployment_url": "<string>",
  "verification_mode": "full",
  "config_hash": "<string>",
  "error": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.lucid.foundation/llms.txt

Use this file to discover all available pages before exploring further.

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)