Agentic Logic

Create a placement

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

Creates a placement — a named slot on a surface that rules serve into.

  • name (string, required) — Merchant-facing placement name.
  • surface (string, required) — onsite, checkout, or post-purchase. Fixed at creation.

The returned placement.id is the placementId used by evaluation requests.

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

Request

Request body

namestring required

Merchant-facing placement name.

surface'onsite' | 'checkout' | 'post-purchase' required

Surface the placement renders on. Fixed at creation.

Response

OK

Changes

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