INintelligems
Agentic Logic

Update a rule

PATCH /v25-10-beta/agentic-logic/rules/{ruleId}

Updates a rule's name, description, settings, or builder-template configuration. The response is { rule }. This endpoint never changes the rule's lifecycle state, and targetSurfaces cannot change.

  • name (string, optional) — New merchant-facing name.
  • description (string, optional, 1–1024 characters) — New plain-language summary.
  • settings (object, optional) — New recommendation settings, the same shape as on create. Replaces the stored object whole: a partial object is not merged.
  • templateParams (object, optional) — New template parameters (builder rules only).
  • templateVersion (number, optional) — New template version (builder rules only; must be sent with templateParams).
  • authoringSessionId (string, optional) — The AI chat session that authored the rule.

Settings and template changes take effect at the next publish; the currently active version keeps serving until then.

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.

patch/v25-10-beta/agentic-logic/rules/{ruleId}

Request

Path parameters

ruleIdstring uuid required

Request body

namestring

New merchant-facing name.

descriptionstring

New plain-language rule summary.

templateParamsobject

New template params for builder rules, validated against the template's params schema at write time.

templateVersioninteger

Template artifact version the new params were authored against.

authoringSessionIdstring

Id of the AI chat session that authored this rule, recorded by the workspace client once the session id is known (the create call is made by a tool that does not carry it). Re-sending the stored id is a no-op; a different id repoints the rule at that newer conversation, which is what a revision session does when it finishes.

Response

OK

Changes

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