POST/api/v1/public/quick-action

Create Task (Quick Action)

Creates and executes a task immediately using FormData. This is the primary endpoint for creating new projects with Helium.

Request

curl -X POST "https://api.he2.ai/api/v1/public/quick-action" \
  -H "X-API-Key: he-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -F "prompt=Create a portfolio website"

Parameters

Parameter	Type	Description
`prompt`	string (optional)	Task description (1-5000 characters). Required if no files provided
`agent_id`	string (optional)	Specific agent to use
`model_name`	string (optional)	Model override
`enable_thinking`	boolean (optional)	Enable thinking mode (default: false)
`reasoning_effort`	string (optional)	"low", "medium", or "high" (default: "low")
`enable_context_manager`	boolean (optional)	Enable context manager (default: false)
`source`	string (optional)	Source platform ("web", "mobile", "widget")
`metadata`	string (optional)	Additional metadata as JSON string
`show_in_recent_tasks`	boolean (optional)	Show task in recent tasks list (default: true)
`files`	file[] (optional)	File uploads

Response

{
  "success": true,
  "project_id": "proj_123",
  "thread_id": "thread_456",
  "agent_run_id": "run_789",
  "message": "Task created and execution started"
}

File Uploads

You can upload files with your request using multipart/form-data:

curl -X POST "https://api.he2.ai/api/v1/public/quick-action" \
  -H "X-API-Key: he-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -F "prompt=Analyze this image and create a website" \
  -F "files=@/path/to/image.png" \
  -F "source=web"

Supported Files

Images: .png, .jpg, .jpeg, .gif, .svg, .webp
Documents: .pdf, .docx, .xlsx, .pptx, .csv
Text: .txt, .json, .xml, .md
Audio: .mp3, .wav, .flac, .aac
Archives: .zip, .rar, .7z

Limits

Max 10 files per request
Max 50MB per file
Max 200MB total