Skip to main content

Warm Session

POST 
/api/internal/agent-coder/:session_id/warm

Warm the sandbox for a session to reduce latency.

Call this endpoint periodically while the user is typing to ensure the sandbox is ready when they send their message.

The sandbox will be kept warm for 5 minutes after the last warm call. If a message is sent while warm, it will be processed immediately.

Returns: WarmStatus with state:

  • 'warming': Sandbox is starting up
  • 'warm': Sandbox is ready for a message
  • 'idle': No workflow running (edge case)

Request​

Responses​

Successful Response