Skip to content

Skyvern: Browser profiles schemas

6 Skyvern schemas with complete fields and constraints.

← Browser profiles operations · All schemas

Create a browser profile — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
browser_session_idJSONOptionalPersistent browser session to convert into a profile. Omit for a blank profile.
browser_session_id (anyOf 1)stringAlternativeMinimum length: 1
browser_session_id (anyOf 2)nullAlternative
descriptionJSONOptionalOptional profile description
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
namestringRequired within parentName for the browser profile
Minimum length: 1
proxy_locationJSONOptionalOptional proxy location for this profile's pinned proxy identity.
proxy_location (anyOf 1)stringAlternativeOne of: RESIDENTIAL, US-CA, US-NY, US-TX, US-FL, US-WA, RESIDENTIAL_ES, RESIDENTIAL_IE, RESIDENTIAL_GB, RESIDENTIAL_IN, RESIDENTIAL_JP, RESIDENTIAL_FR, RESIDENTIAL_DE, RESIDENTIAL_NZ, RESIDENTIAL_ZA, RESIDENTIAL_AR, RESIDENTIAL_AU, RESIDENTIAL_BR, RESIDENTIAL_TR, RESIDENTIAL_CA, RESIDENTIAL_MX, RESIDENTIAL_IT, RESIDENTIAL_NL, RESIDENTIAL_PH, RESIDENTIAL_KR, RESIDENTIAL_SA, RESIDENTIAL_ISP, NONE
proxy_location (anyOf 2)ModelAlternativeExpand Update an agent — response body — proxy location city, country, is ISP, subdivision
proxy_location (anyOf 3)objectAlternativeAdditional keys: allowed
proxy_location (anyOf 4)nullAlternative
proxy_session_idJSONOptionalExplicit sticky-session id for this profile's pinned proxy identity.
proxy_session_id (anyOf 1)stringAlternative
proxy_session_id (anyOf 2)nullAlternative
workflow_run_idJSONOptionalWorkflow run whose persisted session should be captured. Omit for a blank profile.
workflow_run_id (anyOf 1)stringAlternativeMinimum length: 1
workflow_run_id (anyOf 2)nullAlternative

Referenced models: Update an agent — response body — proxy location city, country, is ISP, subdivision

Get browser profile usage — response body

FieldTypePresenceDescription and constraints
$objectRoot
credentialsarrayOptionalDefault: []
credentials[]ModelEach itemExpand Get browser profile usage — response body — credentials item
recent_seeded_run_countJSONOptional
recent_seeded_run_count (anyOf 1)integerAlternativeDefault: 0
recent_seeded_run_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
workflowsarrayOptionalDefault: []
workflows[]ModelEach itemExpand Get browser profile usage — response body — workflows item

Referenced models: Get browser profile usage — response body — credentials item, Get browser profile usage — response body — workflows item

Get browser profile usage — response body — credentials item

FieldTypePresenceDescription and constraints
$objectRoot
credential_idstringRequired within parent
namestringRequired within parent

Get browser profile usage — response body — workflows item

FieldTypePresenceDescription and constraints
$objectRoot
titlestringRequired within parent
viastringRequired within parent
workflow_permanent_idstringRequired within parent

Get browser profile — response body

FieldTypePresenceDescription and constraints
$objectRoot
browser_profile_idstringRequired within parent
browser_profile_key_digestJSONOptional
browser_profile_key_digest (anyOf 1)stringAlternative
browser_profile_key_digest (anyOf 2)nullAlternative
created_atstringRequired within parentFormat: date-time
deleted_atJSONOptional
deleted_at (anyOf 1)stringAlternativeFormat: date-time
deleted_at (anyOf 2)nullAlternative
descriptionJSONOptional
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
is_managedbooleanOptionalDefault: false
last_verified_login_atJSONOptional
last_verified_login_at (anyOf 1)stringAlternativeFormat: date-time
last_verified_login_at (anyOf 2)nullAlternative
linked_credential_idJSONOptional
linked_credential_id (anyOf 1)stringAlternative
linked_credential_id (anyOf 2)nullAlternative
linked_credential_nameJSONOptional
linked_credential_name (anyOf 1)stringAlternative
linked_credential_name (anyOf 2)nullAlternative
modified_atstringRequired within parentFormat: date-time
namestringRequired within parent
organization_idstringRequired within parent
proxy_locationJSONOptional
proxy_location (anyOf 1)ModelAlternativeExpand Update an agent — response body — proxy location string
proxy_location (anyOf 2)ModelAlternativeExpand Update an agent — response body — proxy location city, country, is ISP, subdivision
proxy_location (anyOf 3)objectAlternativeAdditional keys: allowed
proxy_location (anyOf 4)nullAlternative
proxy_session_idJSONOptional
proxy_session_id (anyOf 1)stringAlternative
proxy_session_id (anyOf 2)nullAlternative
source_browser_typeJSONOptional
source_browser_type (anyOf 1)stringAlternative
source_browser_type (anyOf 2)nullAlternative
workflow_permanent_idJSONOptional
workflow_permanent_id (anyOf 1)stringAlternative
workflow_permanent_id (anyOf 2)nullAlternative

Referenced models: Update an agent — response body — proxy location city, country, is ISP, subdivision, Update an agent — response body — proxy location string

Update browser profile — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
descriptionJSONOptionalNew description for the browser profile
description (anyOf 1)stringAlternative
description (anyOf 2)nullAlternative
nameJSONOptionalNew name for the browser profile
name (anyOf 1)stringAlternativeMinimum length: 1
name (anyOf 2)nullAlternative
proxy_locationJSONOptionalOptional proxy location for this profile's pinned proxy identity.
proxy_location (anyOf 1)stringAlternativeOne of: RESIDENTIAL, US-CA, US-NY, US-TX, US-FL, US-WA, RESIDENTIAL_ES, RESIDENTIAL_IE, RESIDENTIAL_GB, RESIDENTIAL_IN, RESIDENTIAL_JP, RESIDENTIAL_FR, RESIDENTIAL_DE, RESIDENTIAL_NZ, RESIDENTIAL_ZA, RESIDENTIAL_AR, RESIDENTIAL_AU, RESIDENTIAL_BR, RESIDENTIAL_TR, RESIDENTIAL_CA, RESIDENTIAL_MX, RESIDENTIAL_IT, RESIDENTIAL_NL, RESIDENTIAL_PH, RESIDENTIAL_KR, RESIDENTIAL_SA, RESIDENTIAL_ISP, NONE
proxy_location (anyOf 2)ModelAlternativeExpand Update an agent — response body — proxy location city, country, is ISP, subdivision
proxy_location (anyOf 3)objectAlternativeAdditional keys: allowed
proxy_location (anyOf 4)nullAlternative
proxy_session_idJSONOptionalOpaque Skyvern-managed proxy sticky-session id.
proxy_session_id (anyOf 1)stringAlternative
proxy_session_id (anyOf 2)nullAlternative
rotate_proxy_session_idbooleanOptionalRotate the Skyvern-managed proxy sticky-session id for this profile.
Default: false

Referenced models: Update an agent — response body — proxy location city, country, is ISP, subdivision

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.