Skip to main content

sypho run

Create a run request for an agent.

Usage​

sypho run <AGENT> [OPTIONS]

Arguments​

ArgumentDescription
AGENTAgent name and version (name:version)

Options​

FlagDescription
--entrypoint <NAME>Entrypoint to execute (default: main)
--input <JSON>Input JSON string
--input-file <PATH>Read input from file
--deployment-type <TYPE>Target deployment type (dev/staging/prod)

Examples​

Simple Run​

sypho run my-agent:0.1.0 \
  --input '{"message": "Hello"}'

From File​

echo '{"query": "What is the weather?"}' > input.json
sypho run weather-agent:0.1.0 --input-file input.json

Target Deployment Type​

sypho run my-agent:0.1.0 \
  --deployment-type dev \
  --input '{"task": "process data"}'

Custom Entrypoint​

sypho run my-agent:0.1.0 \
  --entrypoint worker \
  --input '{"job_id": 123}'

Response​

{
  "run_id": "run_abc123",
  "status": "pending",
  "agent_name": "my-agent",
  "version": "0.1.0",
  "created_at": "2026-07-10T10:00:00.000Z"
}

Monitoring​

View logs:

sypho logs run_abc123

Run Lifecycle​

  1. Created - Run request accepted, initial step queued
  2. Pending - Waiting for runner to claim
  3. Running - Runner executing agent container
  4. Completed - Execution finished successfully
  5. Failed - Execution failed with error

Next Steps​