Skip to main content
GET
Get Profile

Authorizations

X-Api-Key
string
header
required

Path Parameters

profileId
string<uuid>
required

Response

The request has succeeded.

An agent profile containing browser configuration and credentials

adblockActive
boolean
required
allow3rdCookies
boolean
required

Whether to allow third-party cookies

cachePersistence
boolean
required

Whether to persist browser cache between sessions

captchaSolverActive
boolean
required

Whether the captcha solver is active for this profile (managed proxy only)

cookies
object[]
required
createdAt
string<date-time>
required
credentials
object[]
required
deprecated

Deprecated: Use vaultItems instead. Legacy credential names mirrored from attached vault items (legacyName). Prefer vaultItems; ##NAME## remains a grace-period alias.

description
string
required
extensionIds
string<uuid>[]
required

Stable org extension IDs attached to this profile

extraStealth
boolean
required
forcePopupsAsTabsActive
boolean
required

Whether to force popups to open as tabs

id
string<uuid>
required
inboxEmail
string
required

The resolved inbox email address for this profile

mediaBlockerActive
boolean
required

Whether to enable media blocking (images, videos, etc.)

name
string
required

Name of the agent profile (unique within organization)

organizationId
string<uuid>
required

The ID of the organization that owns this profile

pdfViewerActive
boolean
required

Whether to enable the built-in PDF viewer (if disabled, PDFs are downloaded)

popupBlockerActive
boolean
required

Whether to enable popup blocking (requires adblock to be active)

proxyMode
enum<string>
required

Proxy configuration mode

Available options:
none,
managed,
custom,
gateway
stickyIP
boolean
required

Whether to use the same IP address for all executions (managed proxy only)

tracingEnabled
boolean
required

Whether browser tracing is enabled (admin only)

updatedAt
string<date-time>
required
vaultItems
object[]
required

Org vault items attached to this profile. Deleted items are omitted.

customProxy
object

Custom proxy configuration (for custom proxy mode, password excluded)

fingerprintId
string | null

Anchor browser fingerprint ID applied at session create (admin only). Absent or null when unset.

inboxEmailPrefix
string

Optional custom prefix for the agent's inbox email address. If set, the inbox will be {prefix}@agentmail.asteroid.ai. If not set, defaults to the first 8 characters of the profile ID.

operatingSystem
enum<string>

Operating system to emulate in the browser

Available options:
macos,
windows
proxyCC
enum<string>

Country code for proxy location (for managed proxy mode)

Available options:
us,
uk,
fr,
it,
jp,
au,
de,
fi,
ca
proxyGatewayPresetId
string<uuid>

Proxy gateway preset ID (for gateway proxy mode)

proxyType
enum<string>

Type of managed proxy to use (for managed proxy mode)

Available options:
basic