We’ve migrated our documentation to a new site, which means some URLs have changed.
Audience

/ai/segment/recommend/status

API call to check the status of the segment recommendations (/ai/segment/recommend).

The user must be authenticated and have read permissions to the siteGroup. The customer must have the AI feature enabled to generate segment descriptions.

Request

The request object has the following fields:

Name

Type

Required

Description

siteGroupId

String

Yes

SiteGroupId used to generate the segments recommendations

Response

The response object has the following fields:

Name

Type

Description

status

String

One of SUCCESS, PROCESSING, FAILED, UNREQUESTED

lastStatusTime

String

The time when the status has been generated

Status definitions

Status

Description

SUCCESS

The generation of segments have been completed successfully

PROCESSING

The generation of segments is under processing

FAILED

The generation of segments didn't manage to find any recommendations

UNREQUESTED

The generation of segments haven't been requested yet

Examples

Bash
$ python cx.py /ai/segment/recommend/status '{"siteGroupId": "1234567890"}'
{
 "status": "SUCCESS",
 "lastStatusTime": "2026-03-01T12:00:00"
}

Last updated: