Sessions

Queue Session Message

Send a message to a session. If the session is busy it waits on the queue and runs as the next turn; if idle it drains immediately.

interrupt=true cancels the session's active run so this message takes effect now instead of waiting for the current turn (no-op when the session is idle).

post/sessions/{session_id}/queue

Request

  • Base URL: https://api.browser-use.com/api/v4
  • URL: https://api.browser-use.com/api/v4/sessions/{session_id}/queue
  • Auth: API key in header X-Browser-Use-API-Key

Path parameters

session_idstring uuid required

Headers

X-V4-Queue-Deduplicatestring nullable

Request body

textstring required
interruptboolean
attachedFileIdsstring[] nullable

Response

Successful Response

idinteger required
sessionIdstring uuid required
runIdstring uuid nullable required
mode'queue' | 'interrupt' required
status'pending' | 'dispatching' | 'consumed' | 'cancelled' | 'superseded' | 'failed' required
textstring required
attachedFileIdsstring[] nullable
createdAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.