---
title: "Seed Web Browse Auth Profile"
method: PUT
path: "/api/agents/{agent_id}/web-browse-auth-profiles"
tags: ["agents"]
---

# Seed Web Browse Auth Profile

`PUT /api/agents/{agent_id}/web-browse-auth-profiles`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/agents/{agent_id}/web-browse-auth-profiles`
- Auth: none declared

Let this agent browse a site you are already logged into (TOS-3721).

You perform the login yourself, in a real browser, however the site demands
(password, MFA, SSO). This carries the RESULT of that login: the captured
cookies and localStorage become the state new browse sessions for this
agent start from. Nothing here automates a login, and the runner's
password/OTP blocks are unchanged.

Authorization is the same as any other change to this agent's
configuration: the agent itself, or an active owner. Granting is exactly an
owner deciding their own agent may act on a site they can log into.

## Path parameters

- `agent_id` string, uuid, required

## Headers

- `x-impersonate-identity-id` string, nullable

## Request body

- WebBrowseAuthProfileSeed: A captured, already-authenticated browser state for one origin (TOS-3721).
  - `origin` string, required: Site to authenticate on, e.g. https://app.example.com
  - `storage_state` object, required: Playwright storageState captured from a real, human-performed login.
  - `label` string, nullable: Human label shown when listing profiles.

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/5fdd1072e877?raw)