---
title: "Headless Chrome sessions that pause instead of dying (cookies and logins survive). Actions: open, run (steps), screenshot, pause, kill, list. fill values can use {{secret:NAME}}."
method: POST
path: "/api/v1/browser"
tags: ["browser"]
---

# Headless Chrome sessions that pause instead of dying (cookies and logins survive). Actions: open, run (steps), screenshot, pause, kill, list. fill values can use {{secret:NAME}}.

`POST /api/v1/browser`

## Request

- Base URL: `https://cloudforbots.com`
- URL: `https://cloudforbots.com/api/v1/browser`
- Auth: HTTP bearer

## Request body

- object
  - `action` 'open' | 'run' | 'screenshot' | 'pause' | 'kill' | 'list' | 'handoff', required
  - `session` string
  - `kind` string
  - `note` string
  - `fill` string
  - `submit` boolean
  - `wait_s` integer
  - `url` string
  - `steps` object[]
  - `screenshot` boolean
  - `text` boolean
  - `links` boolean
  - `max_text` integer

## Response `200`

url, title, text, links, step results

## Other responses

- `422`: a step failed

---

[API](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api.md) · [All operations](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/revisions/1afdb5648693?raw)