Skip to main content
PATCH
/
agent-profiles
/
{profileId}
Update Agent Profile
curl --request PATCH \
  --url https://odyssey.asteroid.ai/agents/v2/agent-profiles/{profileId} \
  --header 'Content-Type: application/json' \
  --header 'X-Asteroid-Agents-Api-Key: <api-key>' \
  --data '
{
  "cachePersistence": true,
  "captchaSolverActive": true,
  "cookiesToAdd": [
    {
      "domain": "<string>",
      "httpOnly": true,
      "key": "<string>",
      "name": "<string>",
      "sameSite": "Strict",
      "secure": true,
      "value": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "expiry": "2023-11-07T05:31:56Z",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "cookiesToDelete": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "credentialsToAdd": [
    {
      "data": "<string>",
      "name": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "credentialsToDelete": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "description": "<string>",
  "extraStealth": true,
  "name": "<string>",
  "operatingSystem": "macos",
  "proxyCC": "us",
  "proxyType": "basic"
}
'
{
  "cachePersistence": true,
  "captchaSolverActive": true,
  "cookies": [
    {
      "domain": "<string>",
      "httpOnly": true,
      "key": "<string>",
      "name": "<string>",
      "sameSite": "Strict",
      "secure": true,
      "value": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "expiry": "2023-11-07T05:31:56Z",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "credentials": [
    {
      "data": "<string>",
      "name": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "description": "<string>",
  "extraStealth": true,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "stickyIP": true,
  "updatedAt": "2023-11-07T05:31:56Z",
  "operatingSystem": "macos",
  "proxyCC": "us",
  "proxyType": "basic"
}

Authorizations

​
X-Asteroid-Agents-Api-Key
string
header
required

Path Parameters

​
profileId
string<uuid>
required

The ID of the agent profile

Body

application/json

Fields to update

Request to update an existing agent profile

​
cachePersistence
boolean

Whether to persist browser cache between sessions

​
captchaSolverActive
boolean

Whether the captcha solver should be active

​
cookiesToAdd
object[]

Cookies to add to the profile

​
cookiesToDelete
string<uuid>[]

IDs of cookies to remove from the profile

​
credentialsToAdd
object[]

Credentials to add to the profile

​
credentialsToDelete
string<uuid>[]

IDs of credentials to remove from the profile

​
description
string

New description for the profile

Maximum string length: 1000
​
extraStealth
boolean

Whether to enable extra stealth mode

​
name
string

New name for the profile

Required string length: 1 - 255
​
operatingSystem
enum<string>

Operating system to emulate

Available options:
macos,
windows
​
proxyCC
enum<string>

Country code for proxy location

Available options:
us,
uk,
fr,
it,
jp,
au,
de,
fi,
ca
​
proxyType
enum<string>

Type of proxy to use (set to empty string to disable proxy)

Available options:
basic,
residential,
mobile

Response

The request has succeeded.

An agent profile containing browser configuration and credentials

​
cachePersistence
boolean
required

Whether to persist browser cache between sessions

​
captchaSolverActive
boolean
required

Whether the captcha solver is active for this profile

​
cookies
object[]
required

List of cookies associated with this profile

​
createdAt
string<date-time>
required

When the profile was created

​
credentials
object[]
required

List of credentials associated with this profile

​
description
string
required

Description of the agent profile

​
extraStealth
boolean
required

Whether extra stealth mode is enabled

​
id
string<uuid>
required

Unique identifier for the agent profile

​
name
string
required

Name of the agent profile (unique within organization)

​
organizationId
string<uuid>
required

The ID of the organization that owns this profile

​
stickyIP
boolean
required

Whether to use the same IP address for all executions

​
updatedAt
string<date-time>
required

When the profile was last updated

​
operatingSystem
enum<string>

Operating system to emulate

Available options:
macos,
windows
​
proxyCC
enum<string>

Country code for proxy location

Available options:
us,
uk,
fr,
it,
jp,
au,
de,
fi,
ca
​
proxyType
enum<string>

Type of proxy to use

Available options:
basic,
residential,
mobile