---
title: "Share your browser in this workspace [write]"
method: POST
path: "/browser_profiles/{scope}/shares"
tags: ["browser_profiles"]
---

# Share your browser in this workspace \[write\]

`POST /browser_profiles/{scope}/shares`

## Request

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

With one member or everyone here, for every site or only some. Sharing again with the same grantee replaces its sites. Their agents use the sites from their next turn and never see the stored state; new sign-ins in their turns are saved to their own browser.

## Path parameters

- `scope` 'mine', required

## Request body

- ShareBrowserProfile
  - `grantee` union, required: workspace for everyone here, or { user_id } for one member
    - 'workspace'
    - object
      - `user_id` string, required
  - `sites` string[], nullable: Only these sites; omitted or null shares every site

## Response `200`

Shared

- object
  - `share` BrowserProfileShare, required
    - `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/:scope/shares/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/0d435187cd55?raw)