Update Experiment Audience — API Reference

Method -: PUT

https://www.pagesense.zoho.com/pagesense/api/v1/portal/{portal_name}/experimentaudience/{linkname}

Scope Required

PageSense.audience.UPDATE

Description

Assigns or updates the audience for a specific experiment.
This endpoint allows you to modify which predefined or custom audience an experiment targets.
It replaces the previously assigned audience (if any) with the new one referenced by audience_id.
NOTE: Audience changes can alter which visitors are exposed to your experiment.
If the experiment is already Running, you should either pause it before making this call or clearly document how mid-flight audience changes are handled (e.g., apply to new visitors only).

Request

URL parameters

portal_name — Portal identifier (path).
experiment_link_name — Experiment linkname to indicate selection context.

Sample Request

Copiedcurl -X PUT "https://www.pagesense.zoho.com/pagesense/api/v1/portal/my-portal/experimentaudience/homepage-ab-test" \
-H "Authorization: Zoho-oauthtoken {access_token}
-H "Content-Type: application/json" \
-d '{
	"experimentaudience": {
		"audience_id": "1579000000002317"
	}
}'

Response field notes

count (Integer) - Number of experiments processed
status_code (String) - Human-readable status message.
experimentaudience (Array) - details of the experiment whose audience was updated.
experiment_id (Integer) - The ID of the experiment updated.
success (Boolean) - true if the audience update succeeded.
timeTakenToProcessTheRequest (String) - Processing time for this request.

Sample Response

Copied{
	"status_code": "10000",
	"status_string": "All resources were processed successfully.",
	"experimentaudience": [{
		"experiment_id": 1579000000002317,
		"success": true
	}],
	"timeTakenToProcessTheRequest": "83 ms",
	"count": 1
}