/profile
POST/profile
Launches a temporary browser session for creating an authenticated profile. Connect via the returned WebSocket URL, authenticate in the browser, then call Browserless.saveProfile via CDP to capture and persist the auth state. The profile is NOT saved automatically — you must explicitly call Browserless.saveProfile before disconnecting. The session expires after 10 minutes or your plan's session limit, whichever comes first. Free sessions are capped at two minutes; higher-tier plans retain the 10-minute maximum.
Note: This endpoint is also available at: /management/profile for backwards compatibility.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 408
- 429
- 500
- 503
The request contains errors or didn't properly encode content.
The request is missing, or contains bad, authorization credentials.
The request targets a destination that is not allowed.
Resource couldn't be found.
The request took has taken too long to process.
Too many requests are currently being processed.
An internal error occurred when handling the request.
Service is unavailable.