Agentic Logic

Create an assignment

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

Binds a rule to a placement's global cell.

  • placementId (string UUID, required) — Target placement.

  • ruleId (string UUID, required) — Rule to serve.

  • variationId (null, optional) — Only null or an omitted field is accepted. The global cell serves traffic outside any experiment and every variation that has no enabled cell of its own; variation cells come from saving the experience.

  • enabled (boolean, optional, default true) — An enabled assignment serves traffic.

  • budgetMs (integer, optional, 1–10000) — Per-evaluation time budget. Omit it to use the surface's cap; an explicit budget is still capped by the surface's limit.

  • One global assignment per placement; a taken cell answers 409.

  • A code rule can only be assigned to a placement on one of its targetSurfaces; any other surface answers 409.

  • What the slot does when the rule returns nothing is one of the rule's settings, not the assignment's. Set it on the rule.

  • Enabling a code rule requires a published (active) version.

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/assignments

Request

Request body

placementIdstring uuid required

Placement being filled (uuid).

variationIdunknown
ruleIdstring uuid required

Rule that fills it (uuid).

budgetMsinteger

Per-assignment evaluation budget in ms, up to 10000ms. Omit to use the placement surface's cap, which is what serving enforces.

enabledboolean

Per-assignment pause flag. Defaults to true.

Response

OK

Changes

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