---
title: "Your browser and the browsers shared with you [read]"
method: GET
path: "/browser_profiles"
tags: ["browser_profiles"]
---

# Your browser and the browsers shared with you \[read\]

`GET /browser_profiles`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/browser_profiles`
- Auth: HTTP bearer

Your browser is yours in every workspace: sessions whose turn you send open signed in to its sites and save new sign-ins back to it. A browser someone shared with you here lists only the sites they shared. A workspace key gets what is shared with the whole workspace. Cookies are never returned.

## Response `200`

OK

- object
  - `data` BrowserProfile[], required
    - `scope` 'mine' | 'shared' | 'workspace', required: mine: your browser. shared: someone's browser shared with you here, with only the sites they shared. workspace (a workspace key): what is shared with the whole workspace
    - `revision` integer, required: Changes whenever the browser, or for workspace what is shared, changes
    - `owner` object: Whose browser it is, for shared
      - `id` string
      - `email` string, nullable
      - `name` string, nullable
    - `sites` BrowserProfileSite[], required
      - `site` string, required
      - `site_id` string: Stable reference for removal with by=id, on your own browser's sites. Present when new removals are enabled, and always present for incomplete removals.
      - `status` 'ready' | 'needs_signin' | 'removing', required: needs_signin: sign in again. removing: cleanup is incomplete; retry Remove using site_id. The site cannot be used or imported while removal is pending.
      - `signed_in_by` object, nullable, required
        - `id` string
        - `email` string, nullable
        - `name` string, nullable
      - `signed_in_at` string, date-time, required
      - `last_used_at` string, date-time, nullable, required
      - `shareable` boolean: false for a Google login: it stays in its owner's own sessions and is never shared, so a share never includes it.
    - `shares` BrowserProfileShare[]: For mine: whom you shared it with in this workspace
      - `id` string, required
      - `grantee` object, required: Who may use it: everyone in this workspace, or one member
        - `type` 'workspace' | 'member', required
        - `user` object
          - `id` string
          - `email` string, nullable
          - `name` string, nullable
      - `sites` string[], nullable, required: The shared sites; null means every site, including ones signed in later
      - `created_at` string, date-time, required

## Other responses

- `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/browser_profiles/get.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/0d435187cd55?raw)