AlomanaAlomanaAlomana Docs
Agents

Run and stream an agent

Use POST /api/v1/agents-v2/agents/{agent_id}/run-stream/ for a user-facing stream. Send a stable thread_id; Central Hub persists the chat and messages.

curl -N -X POST "$CENTRAL_HUB_URL/api/v1/agents-v2/agents/42/run-stream/" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Space-Slug: acme" \
  -H "Content-Type: application/json" \
  -d '{"thread_id":"contract-demo-1","message":"Summarize the renewal terms."}'

Consume events until the run completes. Use run status, events, history, and cancel endpoints for background integrations. Chats expose persisted history, summaries, plans, share links, and fork operations. Generated sandbox files are persisted to durable storage when delivered; do not assume an E2B path remains available after a run.

On this page