Create Deployment

POST/v1/deployments

Create a manually triggered or scheduled Agent Deployment.

Request body

stringnamerequired

Display name for the Deployment.

stringagent_idrequired

Agent to run.

Optional<string>environment_id

Optional Environment override. Omit to resolve the Agent-owned Environment.

arrayinitial_eventsrequired

At least one valid user.message event.

curl -X POST https://api.sandbase.ai/v1/deployments \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily customer brief",
    "agent_id": "agent_01...",
    "environment_id": "env_01...",
    "initial_events": [{
      "type": "user.message",
      "content": [{"type":"text","text":"Prepare today’s brief."}]
    }],
    "schedule": {
      "type": "cron",
      "expression": "0 9 * * *",
      "timezone": "Asia/Shanghai"
    }
  }'