INintelligems
Agentic Logic

Evaluate

POST /v25-10-beta/agentic-logic/evaluate

Evaluates the active rule assigned to a placement without changing rule or placement state. It returns evaluation telemetry, and does not record an impression.

Use the intelligems-access-token header. The token selects the organization; do not send orgId. The organization must have Agentic Logic enabled.

Rate Limit: 50 requests per 30s window, refilling 25 tokens every 30s.

post/v25-10-beta/agentic-logic/evaluate

Request

Request body

slotsNeededinteger required

How many recommendation slots the caller intends to render. Non-negative integer, at most 50. Zero is legal and asks the rule for an empty result; it is not an error.

visitorIdstring

Seed for the deterministic shuffle (with the rule version). Omitted = a fresh random id per call. Pass a fixed value to make repeat calls comparable against pinned fixtures; live results still drift with the catalog.

countrystring required

ISO 3166-1 alpha-2 country the evaluation should price and read Storefront data for.

variationIdstring uuid nullable

Experiment cell to resolve the assignment in. Null or omitted = the placement's global cell. A named variation resolves its own enabled cell when it has one, and otherwise falls back to the global cell — a disabled variation cell does not suppress the global default.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.