Browser Profiles

curl -X POST https://win.oneshotagent.com/v1/tools/browser/profiles \
  -H "Content-Type: application/json" \
  -H "X-Agent-ID: 0xYourWalletAddress" \
  -d '{"name": "my-github-bot"}'

const profile = await agent.createBrowserProfile("my-github-bot");
console.log(profile.id); // "prof_abc123..."

profile = client.create_browser_profile("my-github-bot")
print(profile["id"])

{
  "id": "prof_abc123",
  "name": "my-github-bot"
}

POST

tools

browser

profiles

curl -X POST https://win.oneshotagent.com/v1/tools/browser/profiles \
  -H "Content-Type: application/json" \
  -H "X-Agent-ID: 0xYourWalletAddress" \
  -d '{"name": "my-github-bot"}'

const profile = await agent.createBrowserProfile("my-github-bot");
console.log(profile.id); // "prof_abc123..."

profile = client.create_browser_profile("my-github-bot")
print(profile["id"])

{
  "id": "prof_abc123",
  "name": "my-github-bot"
}

All paid endpoints on this page accept optional memo (≤ 1000 chars) and decisionContext (object) body fields. Stored on the receipt for debugging and audit — see Audit Trail.

Overview

Browser profiles persist cookies, local storage, and session state between browser tasks. Create a profile once, then pass its profile_id to any browser task to reuse the logged-in state.

Authentication

All profile endpoints require X-Agent-ID header (wallet address). Profiles are scoped to your agent.

Create Profile

string

required

Human-readable profile name (1-100 characters).

curl -X POST https://win.oneshotagent.com/v1/tools/browser/profiles \
  -H "Content-Type: application/json" \
  -H "X-Agent-ID: 0xYourWalletAddress" \
  -d '{"name": "my-github-bot"}'

const profile = await agent.createBrowserProfile("my-github-bot");
console.log(profile.id); // "prof_abc123..."

profile = client.create_browser_profile("my-github-bot")
print(profile["id"])

{
  "id": "prof_abc123",
  "name": "my-github-bot"
}

List Profiles

Returns all profiles for your agent.

curl https://win.oneshotagent.com/v1/tools/browser/profiles \
  -H "X-Agent-ID: 0xYourWalletAddress"

const profiles = await agent.listBrowserProfiles();

profiles = client.list_browser_profiles()

[
  { "id": "prof_abc123", "name": "my-github-bot" },
  { "id": "prof_def456", "name": "linkedin-scraper" }
]

Delete Profile

curl -X DELETE https://win.oneshotagent.com/v1/tools/browser/profiles/prof_abc123 \
  -H "X-Agent-ID: 0xYourWalletAddress"

await agent.deleteBrowserProfile("prof_abc123");

client.delete_browser_profile("prof_abc123")

Using Profiles with Tasks

Pass profile_id to any browser task to reuse the profile’s session state:

// First task: log in (state saved to profile)
await agent.browser({
  task: "Log in to github.com with the provided credentials",
  profile_id: profile.id,
  secrets: { "github.com": "user:token" },
});

// Second task: reuse the logged-in session
const result = await agent.browser({
  task: "Go to github.com/notifications and list unread items",
  profile_id: profile.id,
});

Combine profile_id with secrets for the first task to log in, then use just profile_id for subsequent tasks that reuse the session.

Overview

Email

Email Inbox

Voice

SMS

Commerce

Enrichment

Verification

Research

Build

Notifications

Budgets

Receipts & Analytics

Other

Compute

Browser

Browser Profiles

Overview

Authentication

Create Profile

List Profiles

Delete Profile

Using Profiles with Tasks

​Overview

​Authentication

​Create Profile

​List Profiles

​Delete Profile

​Using Profiles with Tasks

Overview

Authentication

Create Profile

List Profiles

Delete Profile

Using Profiles with Tasks