---
title: "Your recent browser steps"
method: GET
path: "/api/v1/browser/steps"
tags: ["Browser"]
---

# Your recent browser steps

`GET /api/v1/browser/steps`

## Request

- Base URL: `https://saltapp.ai`
- URL: `https://saltapp.ai/api/v1/browser/steps`
- Auth: API key in header `api-key`

## Query parameters

- `browser_client_id` string
- `status` string
- `before` string
- `limit` integer

## Response `200`

OK.

- object
  - `steps` object[]
    - `id` string
    - `step_id` string: Your own idempotency key for this step.
    - `agent_id` string
    - `browser_client_id` string
    - `action` 'open' | 'read' | 'click' | 'type' | 'scroll' | 'screenshot' | 'handoff' | 'tabs'
    - `host` string, nullable
    - `summary` string: One plain line, never page content or typed text.
    - `status` 'queued' | 'sent' | 'running' | 'needs_human' | 'done' | 'failed' | 'refused' | 'stopped' | 'expired'
    - `reason` 'login' | 'captcha' | 'code' | 'payment' | 'confirm_form' | 'confirm_dialog' | 'other' | 'browser_off' | 'site_not_allowed' | 'no_site_access' | 'secret_field' | 'checkout' | 'paused' | 'stopped' | 'expired' | 'bad_args' | 'not_supported' | 'key_changed' | 'not_visible' | 'person_stopped' | 'switch_off' | 'grant_revoked' | 'all_tabs_off' | 'key_mismatch', nullable
    - `created_at` string, date-time
    - `finished_at` string, date-time, nullable
    - `result` string, nullable: PGP armor sealed for your key by the person's extension. Present once the step is done.

## Other responses

- `401`: Missing or invalid credentials.
- `404`: Not found: no grant to this browser, or the feature is off.

---

[API](https://skmtc.dev/saltapp/apis/salt-agent-api.md) · [All operations](https://skmtc.dev/saltapp/apis/salt-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/saltapp/apis/salt-agent-api/revisions/a8b8642ab7f8?raw)