Browsable Browsable Docs

Website Logins API

Website logins are external site sessions that auth-required Browsable tasks can reuse.

Endpoints

GET /v1/website-logins lists sanitized website login accounts.

POST /v1/website-logins starts a hosted login flow and returns an invocation to poll.

DELETE /v1/website-logins/:id deletes a website login account.

GET /v1/website-logins/invocations/:id polls a login invocation.

DELETE /v1/website-logins/invocations/:id cancels a login invocation.

GET /v1/website-logins/location reads the team auth location and sanitized proxy state.

PATCH /v1/website-logins/location sets or resets the team auth location.

List Website Logins

curl "https://api.browsable.app/v1/website-logins?domain=x.com" \

  -H "x-api-key: $BROWSABLE_API_KEY"

Start Login Flow

curl -X POST "https://api.browsable.app/v1/website-logins" \

  -H "x-api-key: $BROWSABLE_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{"domain":"x.com","display_name":"Team X login"}'

Open the returned hosted_url, then poll /v1/website-logins/invocations/:id until the invocation reaches SUCCESS or FAILED.

Delete Website Login

curl -X DELETE "https://api.browsable.app/v1/website-logins/acct_123" \

  -H "x-api-key: $BROWSABLE_API_KEY"

Set Location

curl -X PATCH "https://api.browsable.app/v1/website-logins/location" \

  -H "x-api-key: $BROWSABLE_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{"location":{"country_code":"US","region_code":"CA","city":"San Francisco"}}'