Choose API

POST

/{orgName}/projects/{projectName}/optimization/choose-api

Ingest purpose: Resolve server-side experiments and personalizations for a user before you render or respond.

Use this endpoint to:
• Fetch the correct variation / personalization body for a user
• Resolve experiences by names or groups
• Ensure consistent assignments using sessionId + device (optional but recommended)

What it returns: a choices[] array. Each choice includes:
• name (experience name)
• group (optional group name)
• body (the payload your backend must apply)

Request

Path Params

Query Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

200

Body

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

cURL

Resolve by userId (existing user in Intempt)Resolve multiple groups in one call

curl --location --request POST '//projects//optimization/choose-api?apiKey' \
--header 'Content-Type: application/json' \
--data-raw '{
    "identification": {
        "userId": "customer@example.com"
    },
    "names": [
        "demo-server-side-experiment",
        "demo-server-side-personalization-most-popular"
    ],
    "device": "desktop",
    "sessionId": "sess_web_20260127_001"
}'

Response Example

200 - Success

{
    "choices": []
}

Modified at 2026-01-27 13:25:55

Consent

Recommendations Feed API