Update Audience

Page last updated 12 June 2026

This endpoint updates a single existing audience for a specified project.

PUTapi/management/projects/{projectId}/personalization/audiences/{audienceId}

Parameter

Name	Parameter type	Type	Description
projectId(required)	path	string	The project identifier found in the project overview screen of the management console.

Responses

HTTP status code	Reason	Model
401	Unauthorized	Error
404	Project not found	Error
422	Validation error(s)	Error
500	Internal server error	Error

Examples

Update example with Id update

JSON

{
	"id": "myUpdatedAudience",
	"name": "My New Audience Updated",
	"description": "Example of a new audience",
    "conditions": {
        "and": [
            {
                "id": "testDelete",
                "type": "audience"
            },
            {
                "id": "signalTesting",
                "type": "signal"
            }
        ]
    }
}

Update with no Id to preserve the Id

JSON

{
	"name": "My New Audience Updated",
	"description": "Example of a new audience",
    "conditions": {
        "and": [
            {
                "id": "testDelete",
                "type": "audience"
            },
            {
                "id": "signalTesting",
                "type": "signal"
            }
        ]
    }
}

Remarks

The id can be updated under 2 conditions. The id that you update to must not already exist and the Audience must not be in use as a condition of any other audience.

Still need help?

If you still need help after reading this article, don't hesitate to reach out to the Contensis community on Slack or raise a support ticket to get help from our team.

New support request