Skip to main content
POST
/
task
/
{task_id}
/
event
curl -X POST "https://api.smooth.sh/api/v1/task/YOUR_TASK_ID/event" \
     -H "Content-Type: application/json" \
     -H "apikey: YOUR_API_KEY" \
     -d '{
       "name": "session_action",
       "payload": {
         "name": "run_task",
         "input": {
           "task": "Search for flights from NYC to LA",
           "max_steps": 32
         }
       },
       "id": "evt_abc123"
     }'
{
  "r": {
    "id": "<string>"
  }
}

Authorizations

​
apikey
string
header
required

Path Parameters

​
task_id
string
required

Body

application/json

Event model for sending actions to running tasks.

​
name
string
required

Event type: browser_action, session_action, or tool_call.

​
payload
Payload · object
required

Event payload. For actions: {name, input}. For tool responses: {code, output}.

​
id
string | null

Unique event ID. Used to match responses to requests.

​
timestamp
integer | null

Unix timestamp of the event.

Response

Event successfully sent.

​
r
TaskEventResponse · object
required

Response model for send event operation.