---
title: "Act in the agent's browser during a hand-off [write]"
method: POST
path: "/sessions/{id}/browser-handoff"
---

# Act in the agent's browser during a hand-off \[write\]

`POST /sessions/{id}/browser-handoff`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/sessions/{id}/browser-handoff`
- Auth: HTTP bearer

One action by the caller in the agent's browser, under the same conditions as reading it: `{type: "click", x, y}` (CSS pixels of the frame), `{type: "text", text}` (at most 2,000 characters, typed where the focus is), `{type: "key", key}` (Enter, Tab, Backspace, Escape, the arrows or Space) or `{type: "scroll", x, y, deltaY}`. Answers the page afterwards.

## Path parameters

- `id` string, required

## Request body

- object
  - `type` 'click' | 'text' | 'key' | 'scroll', required
  - `x` number
  - `y` number
  - `text` string
  - `key` 'Enter' | 'Tab' | 'Backspace' | 'Escape' | 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'Space'
  - `deltaY` number

## Response `200`

The agent's browser: `open: false` when none is running, else the page as a JPEG (base64) with its CSS width and height, address and title.

- object
  - `browser` object
    - `open` boolean
    - `url` string
    - `title` string
    - `width` integer
    - `height` integer
    - `jpeg` string: Base64 JPEG of the visible page.

## Other responses

- `400`: Error — { error: { code, message } }
- `403`: Error — { error: { code, message } }
- `404`: Error — { error: { code, message } }
- `503`: Error — { error: { code, message } }
- `default`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/sessions/:id/browser-handoff/post.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)