Skip to main content
Every run automatically creates a session. Pass its session_id / sessionId to create an explicit follow-up turn:
The follow-up restores the agent’s conversation context and workspace. It also reuses the live browser when one is still available. There is no separate empty-session creation step in V4:
  • Omit session_id / sessionId to create a new session implicitly.
  • Pass a previous session ID to continue it explicitly.
  • Pass only workspace_id / workspaceId to start a new conversation that shares existing files.

Queue a follow-up

Use sessions.send_message() / sessions.sendMessage() when a run may still be busy. The message runs immediately if the session is idle, or waits for the current run to finish.
Set interrupt=True / interrupt: true to cancel the active run and start the queued message as soon as possible. A queued response can initially have no run ID; use Get session or List runs to discover the new run once it starts. See Queue session message for the full request shape.