Skip to main content

Updating a Profile with Postman

This guide walks you through updating browser profiles using the Postman API. You can perform a full profile update or a partial profile update to modify specific parameters. Follow the steps below to configure and execute these requests.

Prerequisites​

Before you begin, ensure you have completed the following:

  1. Set Up Indigo X API with Postman: Follow the steps in How to configure Postman for Indigo X API to configure your Postman workspace.
  2. Configure Bearer Token: Set up the Bearer Token for authentication as outlined in the setup guide.
  3. Obtain the profile_id: Retrieve this value from the DevTools panel or the UI.

Profile ID Location

tip

Keep your profile_id handy, as it’s required for both full and partial update requests.

Available Endpoints​

You can use two endpoints to update profiles:

note

The Partial Update endpoint only allows changes to parameters that accept custom inputs, such as proxy, name, navigator_masking, localization_masking, and geolocation_masking.

Updating a Profile​

Follow the steps below to perform a full or partial profile update. Choose the appropriate endpoint based on your needs.

Full Profile Update​

Use the POST Profile Update endpoint to modify all profile parameters.

  1. In your Postman workspace, navigate to the Profile Management section and select the POST Profile Update endpoint.
  2. Go to the Body tab and customize the parameters in the JSON payload (see example below).
  3. Click Send to execute the request.
  4. Verify the response: A 200 status code indicates success.

Partial Profile Update​

Use the POST Profile Partial Update endpoint to modify specific parameters.

  1. In your Postman workspace, navigate to the Profile Management section and select the POST Profile Partial Update endpoint.
  2. Go to the Body tab and add values for the parameters you want to update (e.g., proxy, name, navigator_masking).
  3. Click Send to execute the request.
  4. Verify the response: A 200 status code indicates success.
caution

Ensure the parameters in the Partial Update request are valid and accept custom inputs. Invalid parameters will result in an error.

Example Request Payload​

Below is an example JSON payload for updating a profile. Use this as a template and modify the values as needed.

{
  "name": "Test updated",
  "profile_id": "569e4e66-b7ba-42f5-9622-3f4e2337ac3a",
  "notes": "notes",
  "proxy": {
    "host": "<string>", // IP or HOST
    "type": "url", // HTTP or SOCKS5
    "port": "<integer>", // PORT
    "username": "<string>",
    "password": "<string>"
  },
  "parameters": {
    "flags": {
      "audio_masking": "natural",
      "fonts_masking": "mask",
      "geolocation_masking": "mask",
      "geolocation_popup": "prompt",
      "graphics_masking": "mask",
      "graphics_noise": "mask",
      "localization_masking": "mask",
      "media_devices_masking": "natural",
      "navigator_masking": "mask",
      "ports_masking": "mask",
      "proxy_masking": "custom",
      "screen_masking": "natural",
      "timezone_masking": "mask",
      "webrtc_masking": "mask"
    },
    "storage": {
      "is_local": false,
      "save_service_worker": false
    },
    "fingerprint": {}
  }
}