Agentic Logic

Rule actions

POST /v25-10-beta/agentic-logic/rules/{ruleId}/actions/{action}

Performs a synchronous lifecycle action on a rule.

  • pause — Stop serving the rule. Idempotent: pausing a paused rule returns its current state.
  • resume — Serve the rule again. Requires a published version; a never-published rule answers 409.
  • rollback — Instantly move the active-version pointer to an older published version. Requires version in the body; the rule must be active.

Body: version (number, optional) — Publish number to activate. Required for rollback, rejected for every other action.

  • Publishing and gate dry runs are not actions here — they are asynchronous and have their own endpoints with a poll resource.
  • Retiring a rule is not an action here either — it is DELETE /v25-10-beta/agentic-logic/rules/{ruleId}. archive and restore are rejected.
  • The response returns the rule; rollback additionally returns activeVersionId.

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/rules/{ruleId}/actions/{action}

Request

Path parameters

ruleIdstring uuid required
action'pause' | 'resume' | 'rollback' required

Request body

versioninteger

Publish number of the version to activate. Required for rollback, rejected for the other actions.

Response

OK

activeVersionIdstring

Id of the version row now serving as active. Present after rollback only.

Changes

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