Update cookie config API in Website Scanner

Use this API to update an existing cookie configuration. The API changes only the fields you send. To rotate cookies, send only the cookies field.

update cookie config

PUT /api/website-scanner/v1/cookie_configs/{id}

If Geo Region Restriction (GRR) is enabled for your account, add your region code to the host name: api-accessibility-<region>.browserstack.com. See Geo Region Restriction endpoints for the region codes and examples.

Request parameters

Request

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
     -X PUT "https://api-accessibility.browserstack.com/api/website-scanner/v1/cookie_configs/24" \
     -H "Content-Type: application/json" \
     -d '{ "cookies": "consent=accepted-v2; region=uk" }'

Response attributes 200 OK JSON

Response

{
    "success": true,
    "data": {
        "id": 24,
        "name": "consent_config_1",
        "domain": "example.com",
        "cookies": "consent=accepted-v2; region=uk",
        "createdAt": "2026-10-09T10:00:00Z"
    },
    "error": null
}

Error responses 404 Not Found

The API returns a 404 status code if the cookie configuration ID doesn’t exist or belongs to another account.

Error responses 422 Unprocessable Entity

The API returns a 422 status code when validation fails. The following validation errors can occur:

• A cookie configuration named '<name>' already exists
• '<domain>' is not a valid domain. Send the domain only, without https:// or a path
• Cookie '<entry>' must be in name=value format
• Duplicate cookie name '<name>'
• Cookie name '<name>' is longer than 255 characters
• Cookie '<name>' has a value longer than 4096 characters
• A configuration can hold at most 50 cookies