activator-cli

Creates and inspects Fabric Activator alert rules, sources, and actions via REST APIs.

1.1k|301|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/microsoft/skills-for-fabric --skill activator-cli
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: activator-cli
Source: https://github.com/microsoft/skills-for-fabric/tree/main/plugins/fabric-skills/skills/activator-cli
Command: npx skills add https://github.com/microsoft/skills-for-fabric --skill activator-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill includes references (resource) components.

What problem does it solve?

Setting up Microsoft Fabric Activator (Reflex) alerts requires assembling complex ReflexEntities.json definitions with correctly wired entity graphs, stringified rule templates, and valid source references β€” a process that fails with opaque 400 errors when done by hand.

Core Features & Use Cases

  • Alert Authoring: Create, update, and delete Activator items, rules, data sources (Eventstream, KQL, Real-Time Hub, Power BI, Digital Twin Builder), and actions (Teams, email, Fabric item invocation) through the Fabric REST API.
  • Alert Inspection: List Activators, decode ReflexEntities.json definitions, and explain existing rules, sources, and actions in read-only consumption mode.
  • Use Case: Ask to be notified on Teams when average temperature crosses 30 β€” the skill validates the source data, builds the entity graph with Python, and persists it via updateDefinition.

Quick Start

Ask the assistant to create an Activator alert that emails you when a value in your Eventstream crosses a threshold.

Frequently Asked Questions about activator-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Fabric Activator alert with the REST API?β–Ό

Create the item with POST /v1/workspaces/{id}/reflexes using a displayName body, then persist rules via updateDefinition with a Base64-encoded ReflexEntities.json. Build the payload with Python json.dumps, since PowerShell's ConvertTo-Json corrupts nested JSON strings.

How do I read an existing Activator rule definition?β–Ό

Call getDefinition as a POST with an empty body '{}' β€” a GET returns 405. Poll the Location header if it returns 202, then Base64-decode the ReflexEntities.json part and parse each entity's definition.instance as a JSON string.

What data sources can a Fabric Activator rule monitor?β–Ό

Activator rules support Eventstream, KQL (Eventhouse or external ADX), Real-Time Hub, Power BI semantic model metrics, and Digital Twin Builder / Ontology sources. Each source type has its own entity schema in ReflexEntities.json.

Why does my Activator updateDefinition call fail with a 400 error?β–Ό

Common causes are unresolved entity references (FailedToResolveEntity), a raw template object instead of a stringified definition.instance, or using 'name' instead of 'displayName' in the create body. Run the reference integrity preflight before every updateDefinition call.

Can I get Activator alert firing history from the REST API?β–Ό

Activation history is not available via the public REST API. Use the Activator MCP server endpoint and call the get_activations_for_rule tool with the workspace ID, activator ID, and rule uniqueIdentifier.