Skip to main content
A browser profile is saved login/cookie state — the “stay logged in” of a real browser. It’s a standalone, project-owned resource: you create it once, then reference it by id whenever you want a browser or an agent run to start already logged in.

Create

A new profile is empty. It gets its state the first time it’s used: the agent (or you, over CDP) logs in once inside a browser started with this profile, and when that run or browser ends, the session is saved back into the profile for next time. See Use a profile for how to attach it and how persistence works.

Manage

A profile is a creation input, passed by id — never nested under a browser. There is no browsers/{id}/profile.

Next

Use a profile

Attach the profile to an agent run or a browser you drive yourself.

Log in with the agent

Have the agent do the first login and save the session.